ObjectContext.ExecuteFunction Metoda

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 .

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 .

public:
generic <typename TElement>
 System::Data::Objects::ObjectResult<TElement> ^ ExecuteFunction(System::String ^ functionName, ... cli::array <System::Data::Objects::ObjectParameter ^> ^ parameters);

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>

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é

• Práce s objekty (Entity Framework)

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é

• Práce s objekty (Entity Framework)