ObjectContext.ExecuteFunction Metoda

  • Reference

Definice

Obor názvů:
System.Data.Objects
Sestavení:
System.Data.Entity.dll

Přetížení

ExecuteFunction(String, ObjectParameter[])

Spustí uloženou proceduru nebo funkci, která je definována ve zdroji dat a vyjádřena v konceptuálním modelu; zahodí všechny výsledky vrácené z funkce; a vrátí počet řádků ovlivněných spuštěním.
ExecuteFunction<TElement>(String, ObjectParameter[])

Spustí uloženou proceduru nebo funkci, která je definována ve zdroji dat a mapována v konceptuálním modelu se zadanými parametry. Vrátí typovou ObjectResult<T>hodnotu .
ExecuteFunction<TElement>(String, MergeOption, ObjectParameter[])

Spustí danou uloženou proceduru nebo funkci, která je definována ve zdroji dat a vyjádřena v konceptuálním modelu, se zadanými parametry a možností sloučení. Vrátí typovou ObjectResult<T>hodnotu .

ExecuteFunction(String, ObjectParameter[])

Spustí uloženou proceduru nebo funkci, která je definována ve zdroji dat a vyjádřena v konceptuálním modelu; zahodí všechny výsledky vrácené z funkce; a vrátí počet řádků ovlivněných spuštěním.

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

Parametry

functionName
String

Název uložené procedury nebo funkce. Název může obsahovat název kontejneru, například <Container Name>.<Function Name>. Pokud znáte výchozí název kontejneru, vyžaduje se pouze název funkce.

parameters
ObjectParameter[]

Pole ObjectParameter objektů.

Návraty

Int32

Počet ovlivněných řádků

Výjimky

ArgumentException

function má hodnotu null nebo je prázdná.

-nebo-

function nebyla nalezena.

InvalidOperationException

Čtečka entit tuto functionfunkci nepodporuje.

-nebo-

U čtečky a objektu dochází k neshodě functiontypu .

Platí pro

ExecuteFunction<TElement>(String, ObjectParameter[])

Spustí uloženou proceduru nebo funkci, která je definována ve zdroji dat a mapována v konceptuálním modelu se zadanými parametry. Vrátí typovou ObjectResult<T>hodnotu .

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)

Parametry typu

TElement

Typ entity vrácený ObjectResult<T> při spuštění funkce proti zdroji dat. Tento typ musí implementovat IEntityWithChangeTracker.

Parametry

functionName
String

Název uložené procedury nebo funkce. Název může obsahovat název kontejneru, například <Container Name>.<Function Name>. Pokud znáte výchozí název kontejneru, vyžaduje se pouze název funkce.

parameters
ObjectParameter[]

Pole ObjectParameter objektů.

Návraty

ObjectResult<TElement>

Pro ObjectResult<T> data vrácená uloženou procedurou.

Výjimky

ArgumentException

function má hodnotu null nebo je prázdná.

-nebo-

function nebyla nalezena.

InvalidOperationException

Čtečka entit tuto functionfunkci nepodporuje.

-nebo-

U čtečky a objektu dochází k neshodě functiontypu .

Poznámky

Metoda ExecuteFunction je pomocná metoda, která se používá ke spouštění uložených procedur nebo funkcí, které jsou definovány ve zdroji dat a vyjádřeny v konceptuálním modelu. Nástroje Modelu dat entit vygenerují metodu pro každý element FunctionImport v konceptuálním modelu. Tyto metody volají výraz silného typu ExecuteFunction pro vrácení typu ObjectResult<T>. Další informace najdete v tématu Kód aplikace využívající uložené procedury (Entity Framework).

Všechny parametry funkce jsou požadovány v poli parametrů a všechny typy jsou kontrolovány s metadaty funkce importu, včetně typu samotné funkce. null Hodnoty jsou povoleny pro typy hodnot CLR. Ověření parametru provádí zprostředkovatel.

Metoda ExecuteFunction používá MergeOption hodnotu AppendOnly. Proto pokud objekt již existuje v kontextu objektu, nebude načten ze zdroje dat.

Viz také

Platí pro

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

Spustí danou uloženou proceduru nebo funkci, která je definována ve zdroji dat a vyjádřena v konceptuálním modelu, se zadanými parametry a možností sloučení. Vrátí typovou ObjectResult<T>hodnotu .

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)

Parametry typu

TElement

Typ entity vrácený ObjectResult<T> při spuštění funkce proti zdroji dat. Tento typ musí implementovat IEntityWithChangeTracker.

Parametry

functionName
String

Název uložené procedury nebo funkce. Název může obsahovat název kontejneru, například <Container Name>.<Function Name>. Pokud znáte výchozí název kontejneru, vyžaduje se pouze název funkce.

mergeOption
MergeOption

Parametr , MergeOption který se použije při provádění dotazu.

parameters
ObjectParameter[]

Pole ObjectParameter objektů.

Návraty

ObjectResult<TElement>

Pro ObjectResult<T> data vrácená uloženou procedurou.

Výjimky

ArgumentException

function má hodnotu null nebo je prázdná.

-nebo-

function nebyla nalezena.

InvalidOperationException

Čtečka entit tuto functionfunkci nepodporuje.

-nebo-

U čtečky a objektu dochází k neshodě functiontypu .

Poznámky

Metoda ExecuteFunction je pomocná metoda, která se používá ke spouštění uložených procedur nebo funkcí, které jsou definovány ve zdroji dat a vyjádřeny v koncepčním modelu. Nástroje Modelu dat entit vygenerují metodu pro každý element FunctionImport v konceptuálním modelu. Tyto metody volají výraz silného typu ExecuteFunction pro vrácení typu ObjectResult<T>. Další informace najdete v tématu Kód aplikace využívající uložené procedury (Entity Framework).

Všechny parametry funkce jsou požadovány v poli parametrů a všechny typy jsou kontrolovány s metadaty funkce importu, včetně typu samotné funkce. null Hodnoty jsou povoleny pro typy hodnot CLR. Ověření parametru provádí zprostředkovatel.

Viz také

Platí pro