ObjectContext.ExecuteFunction Methode

Definitie

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

Overloads

Name Description
ExecuteFunction(String, ObjectParameter[])

Voert een opgeslagen procedure of functie uit die is gedefinieerd in de gegevensbron en uitgedrukt in het conceptuele model; verwijdert alle resultaten die zijn geretourneerd door de functie; en retourneert het aantal rijen dat wordt beïnvloed door de uitvoering.
ExecuteFunction<TElement>(String, ObjectParameter[])

Hiermee wordt een opgeslagen procedure of functie uitgevoerd die is gedefinieerd in de gegevensbron en die is toegewezen in het conceptuele model, met de opgegeven parameters. Retourneert een getypte ObjectResult<T>.
ExecuteFunction<TElement>(String, MergeOption, ObjectParameter[])

Hiermee wordt de opgegeven opgeslagen procedure of functie uitgevoerd die is gedefinieerd in de gegevensbron en uitgedrukt in het conceptuele model, met de opgegeven parameters en de samenvoegoptie. Retourneert een getypte ObjectResult<T>.

ExecuteFunction(String, ObjectParameter[])

Voert een opgeslagen procedure of functie uit die is gedefinieerd in de gegevensbron en uitgedrukt in het conceptuele model; verwijdert alle resultaten die zijn geretourneerd door de functie; en retourneert het aantal rijen dat wordt beïnvloed door de uitvoering.

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

Parameters

functionName
String

De naam van de opgeslagen procedure of functie. De naam kan de containernaam bevatten, zoals <Container Name>.<Function Name>. Wanneer de standaardcontainernaam bekend is, is alleen de functienaam vereist.

parameters
ObjectParameter[]

Een matrix met ObjectParameter objecten.

Retouren

Int32

Het aantal rijen dat is beïnvloed.

Uitzonderingen

ArgumentException

functionName is null of leeg.

– of –

functionName is niet gevonden.

InvalidOperationException

De entiteitslezer biedt geen ondersteuning voor dit functionName.

– of –

Er is een type dat niet overeenkomt met de lezer en de functie.

Van toepassing op

ExecuteFunction<TElement>(String, ObjectParameter[])

Hiermee wordt een opgeslagen procedure of functie uitgevoerd die is gedefinieerd in de gegevensbron en die is toegewezen in het conceptuele model, met de opgegeven parameters. Retourneert een getypte 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)

Type parameters

TElement

Het entiteitstype van het ObjectResult<T> geretourneerde type wanneer de functie wordt uitgevoerd op de gegevensbron. Dit type moet worden geïmplementeerd IEntityWithChangeTracker.

Parameters

functionName
String

De naam van de opgeslagen procedure of functie. De naam kan de containernaam bevatten, zoals <Container Name>.<Function Name>. Wanneer de standaardcontainernaam bekend is, is alleen de functienaam vereist.

parameters
ObjectParameter[]

Een matrix met ObjectParameter objecten.

Retouren

ObjectResult<TElement>

Een ObjectResult<T> voor de gegevens die worden geretourneerd door de opgeslagen procedure.

Uitzonderingen

ArgumentException

functionName is null of leeg

– of –

functionName is niet gevonden.

InvalidOperationException

De entiteitslezer biedt geen ondersteuning voor deze functie.

– of –

Er is een type dat niet overeenkomt met de lezer en de functie.

Opmerkingen

De ExecuteFunction methode is een helpermethode die wordt gebruikt voor het uitvoeren van opgeslagen procedures of functies die zijn gedefinieerd in de gegevensbron en uitgedrukt in het conceptuele model. De hulpprogramma's voor entiteitsgegevensmodellen genereren een methode voor elk FunctionImport-element in het conceptuele model. Met deze methoden wordt een sterk getypte ExecuteFunction methode aangeroepen om een getypte ObjectResult<T>waarde te retourneren. Zie Toepassingscode met behulp van opgeslagen procedures (Entity Framework) voor meer informatie.

Alle parameters voor de functie zijn vereist in de parametersmatrix en alle typen worden gecontroleerd op basis van de metagegevens voor de importfunctie, inclusief het type van de functie zelf. null waarden zijn toegestaan voor CLR-waardetypen. Parametervalidatie wordt uitgevoerd door de provider.

De ExecuteFunction methode gebruikt de MergeOption waarde van AppendOnly. Als er al een object in de objectcontext bestaat, wordt het dus niet geladen vanuit de gegevensbron.

Zie ook

Van toepassing op

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

Hiermee wordt de opgegeven opgeslagen procedure of functie uitgevoerd die is gedefinieerd in de gegevensbron en uitgedrukt in het conceptuele model, met de opgegeven parameters en de samenvoegoptie. Retourneert een getypte 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)

Type parameters

TElement

Het entiteitstype van het ObjectResult<T> geretourneerde type wanneer de functie wordt uitgevoerd op de gegevensbron. Dit type moet worden geïmplementeerd IEntityWithChangeTracker.

Parameters

functionName
String

De naam van de opgeslagen procedure of functie. De naam kan de containernaam bevatten, zoals <Container Name>.<Function Name>. Wanneer de standaardcontainernaam bekend is, is alleen de functienaam vereist.

mergeOption
MergeOption

De MergeOption te gebruiken bij het uitvoeren van de query.

parameters
ObjectParameter[]

Een matrix met ObjectParameter objecten.

Retouren

ObjectResult<TElement>

Een ObjectResult<T> voor de gegevens die worden geretourneerd door de opgeslagen procedure.

Uitzonderingen

ArgumentException

functionName is null of leeg

– of –

functionName is niet gevonden.

InvalidOperationException

De entiteitslezer biedt geen ondersteuning voor deze functie.

– of –

Er is een type dat niet overeenkomt met de lezer en de functie.

Opmerkingen

De ExecuteFunction methode is een helpermethode die wordt gebruikt voor het uitvoeren van opgeslagen procedures of functies die zijn gedefinieerd in de gegevensbron en uitgedrukt in conceptueel model. De hulpprogramma's voor entiteitsgegevensmodellen genereren een methode voor elk FunctionImport-element in het conceptuele model. Met deze methoden wordt een sterk getypte ExecuteFunction methode aangeroepen om een getypte ObjectResult<T>waarde te retourneren. Zie Toepassingscode met behulp van opgeslagen procedures (Entity Framework) voor meer informatie.

Alle parameters voor de functie zijn vereist in de parametersmatrix en alle typen worden gecontroleerd op basis van de metagegevens voor de importfunctie, inclusief het type van de functie zelf. null waarden zijn toegestaan voor CLR-waardetypen. Parametervalidatie wordt uitgevoerd door de provider.

Zie ook

Van toepassing op