Freigeben über

ObjectContext.ExecuteFunction Methode

Definition

Namespace:
System.Data.Objects
Assembly:
System.Data.Entity.dll

Überlädt

Name Beschreibung
ExecuteFunction(String, ObjectParameter[])

Führt eine gespeicherte Prozedur oder Funktion aus, die in der Datenquelle definiert und im konzeptionellen Modell ausgedrückt wird; verwirft alle ergebnisse, die von der Funktion zurückgegeben werden; und gibt die Anzahl der Zeilen zurück, die von der Ausführung betroffen sind.
ExecuteFunction<TElement>(String, ObjectParameter[])

Führt eine gespeicherte Prozedur oder Funktion aus, die in der Datenquelle definiert und im konzeptionellen Modell mit den angegebenen Parametern zugeordnet ist. Gibt einen eingegebenen Wert zurück ObjectResult<T>.
ExecuteFunction<TElement>(String, MergeOption, ObjectParameter[])

Führt die angegebene gespeicherte Prozedur oder Funktion aus, die in der Datenquelle definiert und im konzeptionellen Modell ausgedrückt wird, mit den angegebenen Parametern und der Zusammenführungsoption. Gibt einen eingegebenen Wert zurück ObjectResult<T>.

ExecuteFunction(String, ObjectParameter[])

Führt eine gespeicherte Prozedur oder Funktion aus, die in der Datenquelle definiert und im konzeptionellen Modell ausgedrückt wird; verwirft alle ergebnisse, die von der Funktion zurückgegeben werden; und gibt die Anzahl der Zeilen zurück, die von der Ausführung betroffen sind.

public:
 int ExecuteFunction(System::String ^ functionName, ... cli::array <System::Data::Objects::ObjectParameter ^> ^ parameters);
public int ExecuteFunction(string functionName, params System.Data.Objects.ObjectParameter[] parameters);
member this.ExecuteFunction : string * System.Data.Objects.ObjectParameter[] -> int
Public Function ExecuteFunction (functionName As String, ParamArray parameters As ObjectParameter()) As Integer

Parameter

functionName
String

Der Name der gespeicherten Prozedur oder Funktion. Der Name kann den Containernamen enthalten, z <Container Name>.<Function Name>. B. . Wenn der Standardcontainername bekannt ist, ist nur der Funktionsname erforderlich.

parameters
ObjectParameter[]

Ein Array von ObjectParameter-Objekten.

Gibt zurück

Int32

Die Anzahl der betroffenen Zeilen.

Ausnahmen

ArgumentException

functionName ist NULL oder leer.

- oder -

functionName wurde nicht gefunden.

InvalidOperationException

Dies wird vom Entitätsleser nicht unterstützt functionName.

- oder -

Für den Leser und die Funktion gibt es einen Typkonflikt.

Gilt für:

ExecuteFunction<TElement>(String, ObjectParameter[])

Führt eine gespeicherte Prozedur oder Funktion aus, die in der Datenquelle definiert und im konzeptionellen Modell mit den angegebenen Parametern zugeordnet ist. Gibt einen eingegebenen Wert zurück ObjectResult<T>.

protected:
generic <typename TElement>
 where TElement : System::Data::Objects::DataClasses::IEntityWithChangeTracker System::Data::Objects::ObjectResult<TElement> ^ ExecuteFunction(System::String ^ functionName, ... cli::array <System::Data::Objects::ObjectParameter ^> ^ parameters);
public:
generic <typename TElement>
 System::Data::Objects::ObjectResult<TElement> ^ ExecuteFunction(System::String ^ functionName, ... cli::array <System::Data::Objects::ObjectParameter ^> ^ parameters);
protected System.Data.Objects.ObjectResult<TElement> ExecuteFunction<TElement>(string functionName, params System.Data.Objects.ObjectParameter[] parameters) where TElement : System.Data.Objects.DataClasses.IEntityWithChangeTracker;
public System.Data.Objects.ObjectResult<TElement> ExecuteFunction<TElement>(string functionName, params System.Data.Objects.ObjectParameter[] parameters);
member this.ExecuteFunction : string * System.Data.Objects.ObjectParameter[] -> System.Data.Objects.ObjectResult<'Element (requires 'Element :> System.Data.Objects.DataClasses.IEntityWithChangeTracker)> (requires 'Element :> System.Data.Objects.DataClasses.IEntityWithChangeTracker)
member this.ExecuteFunction : string * System.Data.Objects.ObjectParameter[] -> System.Data.Objects.ObjectResult<'Element>
Protected Function ExecuteFunction(Of TElement As IEntityWithChangeTracker) (functionName As String, ParamArray parameters As ObjectParameter()) As ObjectResult(Of TElement)
Public Function ExecuteFunction(Of TElement) (functionName As String, ParamArray parameters As ObjectParameter()) As ObjectResult(Of TElement)

Typparameter

TElement

Der Entitätstyp des ObjectResult<T> zurückgegebenen Elements, wenn die Funktion für die Datenquelle ausgeführt wird. Dieser Typ muss implementiert werden IEntityWithChangeTracker.

Parameter

functionName
String

Der Name der gespeicherten Prozedur oder Funktion. Der Name kann den Containernamen enthalten, z <Container Name>.<Function Name>. B. . Wenn der Standardcontainername bekannt ist, ist nur der Funktionsname erforderlich.

parameters
ObjectParameter[]

Ein Array von ObjectParameter-Objekten.

Gibt zurück

ObjectResult<TElement>

Eine ObjectResult<T> für die Daten, die von der gespeicherten Prozedur zurückgegeben werden.

Ausnahmen

ArgumentException

functionName ist NULL oder leer.

- oder -

functionName wurde nicht gefunden.

InvalidOperationException

Der Entitätsleser unterstützt diese Funktion nicht.

- oder -

Für den Leser und die Funktion gibt es einen Typkonflikt.

Hinweise

Die ExecuteFunction Methode ist eine Hilfsmethode, die zum Ausführen gespeicherter Prozeduren oder Funktionen verwendet wird, die in der Datenquelle definiert und im konzeptionellen Modell ausgedrückt werden. Die Entitätsdatenmodelltools generieren eine Methode für jedes FunctionImport-Element im konzeptionellen Modell. Diese Methoden rufen eine stark typierte ExecuteFunction Methode auf, um einen typierten ObjectResult<T>Wert zurückzugeben.

Alle Parameter für die Funktion sind im Parameterarray erforderlich, und alle Typen werden anhand der Metadaten für die Importfunktion überprüft, einschließlich des Typs der Funktion selbst. null Werte sind für CLR-Werttypen zulässig. Die Parameterüberprüfung wird vom Anbieter ausgeführt.

Die ExecuteFunction Methode verwendet den MergeOption Wert von AppendOnly. Wenn ein Objekt im Objektkontext bereits vorhanden ist, wird es daher nicht aus der Datenquelle geladen.

Weitere Informationen

Gilt für:

ExecuteFunction<TElement>(String, MergeOption, ObjectParameter[])

Führt die angegebene gespeicherte Prozedur oder Funktion aus, die in der Datenquelle definiert und im konzeptionellen Modell ausgedrückt wird, mit den angegebenen Parametern und der Zusammenführungsoption. Gibt einen eingegebenen Wert zurück ObjectResult<T>.

public:
generic <typename TElement>
 System::Data::Objects::ObjectResult<TElement> ^ ExecuteFunction(System::String ^ functionName, System::Data::Objects::MergeOption mergeOption, ... cli::array <System::Data::Objects::ObjectParameter ^> ^ parameters);
public System.Data.Objects.ObjectResult<TElement> ExecuteFunction<TElement>(string functionName, System.Data.Objects.MergeOption mergeOption, params System.Data.Objects.ObjectParameter[] parameters);
member this.ExecuteFunction : string * System.Data.Objects.MergeOption * System.Data.Objects.ObjectParameter[] -> System.Data.Objects.ObjectResult<'Element>
Public Function ExecuteFunction(Of TElement) (functionName As String, mergeOption As MergeOption, ParamArray parameters As ObjectParameter()) As ObjectResult(Of TElement)

Typparameter

TElement

Der Entitätstyp des ObjectResult<T> zurückgegebenen Elements, wenn die Funktion für die Datenquelle ausgeführt wird. Dieser Typ muss implementiert werden IEntityWithChangeTracker.

Parameter

functionName
String

Der Name der gespeicherten Prozedur oder Funktion. Der Name kann den Containernamen enthalten, z <Container Name>.<Function Name>. B. . Wenn der Standardcontainername bekannt ist, ist nur der Funktionsname erforderlich.

mergeOption
MergeOption

Die MergeOption zu verwendende Verwendung beim Ausführen der Abfrage.

parameters
ObjectParameter[]

Ein Array von ObjectParameter-Objekten.

Gibt zurück

ObjectResult<TElement>

Eine ObjectResult<T> für die Daten, die von der gespeicherten Prozedur zurückgegeben werden.

Ausnahmen

ArgumentException

functionName ist NULL oder leer.

- oder -

functionName wurde nicht gefunden.

InvalidOperationException

Der Entitätsleser unterstützt diese Funktion nicht.

- oder -

Für den Leser und die Funktion gibt es einen Typkonflikt.

Hinweise

Die ExecuteFunction Methode ist eine Hilfsmethode, die zum Ausführen gespeicherter Prozeduren oder Funktionen verwendet wird, die in der Datenquelle definiert und im konzeptionellen Modell ausgedrückt werden. Die Entitätsdatenmodelltools generieren eine Methode für jedes FunctionImport-Element im konzeptionellen Modell. Diese Methoden rufen eine stark typierte ExecuteFunction Methode auf, um einen typierten ObjectResult<T>Wert zurückzugeben.

Alle Parameter für die Funktion sind im Parameterarray erforderlich, und alle Typen werden anhand der Metadaten für die Importfunktion überprüft, einschließlich des Typs der Funktion selbst. null Werte sind für CLR-Werttypen zulässig. Die Parameterüberprüfung wird vom Anbieter ausgeführt.

Weitere Informationen

Gilt für: