ObjectContext.ExecuteFunction Methode

  • Referenz

Definition

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

Überlädt

ExecuteFunction(String, ObjectParameter[])

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

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

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

ExecuteFunction(String, ObjectParameter[])

Führt eine gespeicherte Prozedur oder eine Funktion aus, die in der Datenquelle definiert ist und im konzeptionellen Modell ausgedrückt wird, verwirft alle von der Funktion zurückgegebenen Ergebnisse, und gibt die von der Ausführung betroffene Anzahl von Zeilen zurück.

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. B <Container Name>.<Function Name>. . Wenn der Standardcontainername bekannt ist, wird nur der Funktionsname benötigt.

parameters
ObjectParameter[]

Ein Array von ObjectParameter-Objekten.

Gibt zurück

Int32

Die Anzahl der betroffenen Zeilen.

Ausnahmen

ArgumentException

function ist NULL oder leer.

- oder -

function wurde nicht gefunden.

InvalidOperationException

Der Entitätsreader unterstützt diese function nicht.

- oder -

Zwischen dem Reader und der function ist ein Typenkonflikt vorhanden.

Gilt für:

ExecuteFunction<TElement>(String, ObjectParameter[])

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

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 zurückgegebenen ObjectResult<T>, wenn die Funktion für die Datenquelle ausgeführt wird. Dieser Typ muss IEntityWithChangeTracker implementieren.

Parameter

functionName
String

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

parameters
ObjectParameter[]

Ein Array von ObjectParameter-Objekten.

Gibt zurück

ObjectResult<TElement>

Ein ObjectResult<T> für die von der gespeicherten Prozedur zurückgegebenen Daten.

Ausnahmen

ArgumentException

function ist NULL oder leer.

- oder -

function wurde nicht gefunden.

InvalidOperationException

Der Entitätsreader unterstützt diese function nicht.

- oder -

Zwischen dem Reader und der function ist ein Typenkonflikt vorhanden.

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 Entity Data Model-Tools generieren eine Methode für jedes FunctionImport-Element im konzeptionellen Modell. Diese Methoden rufen einen stark typisierten ExecuteFunction auf, um einen typisierten ObjectResult<T>zurückzugeben. Weitere Informationen finden Sie unter Anwendungscode mit gespeicherten Prozeduren (Entity Framework).

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. Parametervalidierung wird vom Anbieter durchgeführt.

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

Weitere Informationen

Gilt für:

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

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

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 zurückgegebenen ObjectResult<T>, wenn die Funktion für die Datenquelle ausgeführt wird. Dieser Typ muss IEntityWithChangeTracker implementieren.

Parameter

functionName
String

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

mergeOption
MergeOption

Die beim Ausführen der Abfrage zu verwendende MergeOption.

parameters
ObjectParameter[]

Ein Array von ObjectParameter-Objekten.

Gibt zurück

ObjectResult<TElement>

Ein ObjectResult<T> für die von der gespeicherten Prozedur zurückgegebenen Daten.

Ausnahmen

ArgumentException

function ist NULL oder leer.

- oder -

function wurde nicht gefunden.

InvalidOperationException

Der Entitätsreader unterstützt diese function nicht.

- oder -

Zwischen dem Reader und der function ist ein Typenkonflikt vorhanden.

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 Entity Data Model-Tools generieren eine Methode für jedes FunctionImport-Element im konzeptionellen Modell. Diese Methoden rufen einen stark typisierten ExecuteFunction auf, um einen typisierten ObjectResult<T>zurückzugeben. Weitere Informationen finden Sie unter Anwendungscode mit gespeicherten Prozeduren (Entity Framework).

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. Parametervalidierung wird vom Anbieter durchgeführt.

Weitere Informationen

Gilt für: