ObjectContext.ExecuteFunction Metoda

  • Odwołanie

Definicja

Przestrzeń nazw:
System.Data.Objects
Zestaw:
System.Data.Entity.dll

Przeciążenia

ExecuteFunction(String, ObjectParameter[])

Wykonuje procedurę składowaną lub funkcję zdefiniowaną w źródle danych i wyrażoną w modelu koncepcyjnym; odrzuca wszystkie wyniki zwrócone z funkcji; i zwraca liczbę wierszy, których dotyczy wykonanie.
ExecuteFunction<TElement>(String, ObjectParameter[])

Wykonuje procedurę składowaną lub funkcję zdefiniowaną w źródle danych i zamapowaną w modelu koncepcyjnym z określonymi parametrami. Zwraca typizowane ObjectResult<T>polecenie .
ExecuteFunction<TElement>(String, MergeOption, ObjectParameter[])

Wykonuje daną procedurę składowaną lub funkcję zdefiniowaną w źródle danych i wyrażoną w modelu koncepcyjnym z określonymi parametrami i opcją scalania. Zwraca typizowane ObjectResult<T>polecenie .

ExecuteFunction(String, ObjectParameter[])

Wykonuje procedurę składowaną lub funkcję zdefiniowaną w źródle danych i wyrażoną w modelu koncepcyjnym; odrzuca wszystkie wyniki zwrócone z funkcji; i zwraca liczbę wierszy, których dotyczy wykonanie.

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

Nazwa procedury składowanej lub funkcji. Nazwa może zawierać nazwę kontenera, na przykład <Container Name>.<Function Name>. Gdy domyślna nazwa kontenera jest znana, wymagana jest tylko nazwa funkcji.

parameters
ObjectParameter[]

Tablica ObjectParameter obiektów.

Zwraca

Int32

Liczba wierszy, których dotyczy problem.

Wyjątki

ArgumentException

function ma wartość null lub jest pusta

-lub-

function nie można odnaleźć.

InvalidOperationException

Czytnik jednostek nie obsługuje tego elementu function.

-lub-

W czytniku występuje niezgodność typów i function.

Dotyczy

ExecuteFunction<TElement>(String, ObjectParameter[])

Wykonuje procedurę składowaną lub funkcję zdefiniowaną w źródle danych i zamapowaną w modelu koncepcyjnym z określonymi parametrami. Zwraca typizowane ObjectResult<T>polecenie .

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 jednostki zwrócony ObjectResult<T> po wykonaniu funkcji względem źródła danych. Ten typ musi implementować IEntityWithChangeTracker.

Parametry

functionName
String

Nazwa procedury składowanej lub funkcji. Nazwa może zawierać nazwę kontenera, na przykład <Container Name>.<Function Name>. Gdy domyślna nazwa kontenera jest znana, wymagana jest tylko nazwa funkcji.

parameters
ObjectParameter[]

Tablica ObjectParameter obiektów.

Zwraca

ObjectResult<TElement>

Element ObjectResult<T> dla danych zwracanych przez procedurę składowaną.

Wyjątki

ArgumentException

function ma wartość null lub jest pusta

-lub-

function nie można odnaleźć.

InvalidOperationException

Czytnik jednostek nie obsługuje tego elementu function.

-lub-

W czytniku występuje niezgodność typów i function.

Uwagi

Metoda ExecuteFunction jest metodą pomocnika, która służy do wykonywania procedur składowanych lub funkcji zdefiniowanych w źródle danych i wyrażonych w modelu koncepcyjnym. Narzędzia modelu danych jednostki generują metodę dla każdego elementu FunctionImport w modelu koncepcyjnym. Te metody nazywają silnie typizowane ExecuteFunction , aby zwrócić typizowane ObjectResult<T>. Aby uzyskać więcej informacji, zobacz Kod aplikacji przy użyciu procedur składowanych (Entity Framework).

Wszystkie parametry funkcji są wymagane w tablicy parametrów, a wszystkie typy są sprawdzane względem metadanych funkcji importu, w tym typu samej funkcji. null wartości są dozwolone dla typów wartości CLR. Walidacja parametru jest wykonywana przez dostawcę.

Metoda ExecuteFunction używa MergeOption wartości AppendOnly. W związku z tym, jeśli obiekt już istnieje w kontekście obiektu, nie zostanie załadowany ze źródła danych.

Zobacz też

Dotyczy

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

Wykonuje daną procedurę składowaną lub funkcję zdefiniowaną w źródle danych i wyrażoną w modelu koncepcyjnym z określonymi parametrami i opcją scalania. Zwraca typizowane ObjectResult<T>polecenie .

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 jednostki zwrócony ObjectResult<T> po wykonaniu funkcji względem źródła danych. Ten typ musi implementować IEntityWithChangeTracker.

Parametry

functionName
String

Nazwa procedury składowanej lub funkcji. Nazwa może zawierać nazwę kontenera, na przykład <Container Name>.<Function Name>. Gdy domyślna nazwa kontenera jest znana, wymagana jest tylko nazwa funkcji.

mergeOption
MergeOption

Element MergeOption do użycia podczas wykonywania zapytania.

parameters
ObjectParameter[]

Tablica ObjectParameter obiektów.

Zwraca

ObjectResult<TElement>

Element ObjectResult<T> dla danych zwracanych przez procedurę składowaną.

Wyjątki

ArgumentException

function ma wartość null lub jest pusta

-lub-

function nie można odnaleźć.

InvalidOperationException

Czytnik jednostek nie obsługuje tego elementu function.

-lub-

W czytniku występuje niezgodność typów i function.

Uwagi

Metoda ExecuteFunction jest metodą pomocnika, która służy do wykonywania procedur składowanych lub funkcji zdefiniowanych w źródle danych i wyrażonych w modelu koncepcyjnym. Narzędzia modelu danych jednostki generują metodę dla każdego elementu FunctionImport w modelu koncepcyjnym. Te metody nazywają silnie typizowane ExecuteFunction , aby zwrócić typizowane ObjectResult<T>. Aby uzyskać więcej informacji, zobacz Kod aplikacji przy użyciu procedur składowanych (Entity Framework).

Wszystkie parametry funkcji są wymagane w tablicy parametrów, a wszystkie typy są sprawdzane względem metadanych funkcji importu, w tym typu samej funkcji. null wartości są dozwolone dla typów wartości CLR. Walidacja parametru jest wykonywana przez dostawcę.

Zobacz też

Dotyczy