Поделиться через

ObjectContext.ExecuteFunction Метод

  • Ссылка

Определение

Пространство имен:
System.Data.Objects
Сборка:
System.Data.Entity.dll

Перегрузки

ExecuteFunction(String, ObjectParameter[])

Выполняет хранимую процедуру или функцию, определенную в источнике данных и выраженную в концептуальной модели; отменяет любые результаты, возвращенные функцией; возвращает количество строк, обработанных при выполнении команды.
ExecuteFunction<TElement>(String, ObjectParameter[])

Выполняет хранимую процедуру или функцию, определенную в источнике данных и сопоставленную в концептуальной модели (с применением указанных параметров). Возвращает типизированный объект ObjectResult<T>.
ExecuteFunction<TElement>(String, MergeOption, ObjectParameter[])

Выполняет данную хранимую процедуру или функцию, определенную в источнике данных и выраженную в концептуальной модели (с применением указанных параметров и команды слияния). Возвращает типизированный объект ObjectResult<T>.

ExecuteFunction(String, ObjectParameter[])

Выполняет хранимую процедуру или функцию, определенную в источнике данных и выраженную в концептуальной модели; отменяет любые результаты, возвращенные функцией; возвращает количество строк, обработанных при выполнении команды.

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

Параметры

functionName
String

Имя хранимой процедуры или функции. Имя может включать имя контейнера, например <Container Name>.<Function Name>. Если имя контейнера по умолчанию известно, требуется только имя функции.

parameters
ObjectParameter[]

Массив объектов ObjectParameter.

Возвращаемое значение

Int32

Число обработанных строк.

Исключения

ArgumentException

Параметр function имеет значение null или пуст

-или-

function не найден.

InvalidOperationException

Средство чтения сущностей не поддерживает эту функцию function.

-или-

Несоответствие типов между средством чтения и функцией function.

Применяется к

ExecuteFunction<TElement>(String, ObjectParameter[])

Выполняет хранимую процедуру или функцию, определенную в источнике данных и сопоставленную в концептуальной модели (с применением указанных параметров). Возвращает типизированный объект 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)

Параметры типа

TElement

Тип сущности объекта ObjectResult<T>, возвращаемого при выполнении функции в отношении источника данных. Данный тип должен реализовывать IEntityWithChangeTracker.

Параметры

functionName
String

Имя хранимой процедуры или функции. Имя может включать имя контейнера, например <Container Name>.<Function Name>. Если имя контейнера по умолчанию известно, требуется только имя функции.

parameters
ObjectParameter[]

Массив объектов ObjectParameter.

Возвращаемое значение

ObjectResult<TElement>

Объект ObjectResult<T> для данных, возвращенных хранимой процедурой.

Исключения

ArgumentException

Параметр function имеет значение null или пуст

-или-

function не найден.

InvalidOperationException

Средство чтения сущностей не поддерживает эту функцию function.

-или-

Несоответствие типов между средством чтения и функцией function.

Комментарии

Метод ExecuteFunction является вспомогательным методом, который используется для выполнения хранимых процедур или функций, определенных в источнике данных и выраженных в концептуальной модели. Средства entity Data Model создают метод для каждого элемента FunctionImport в концептуальной модели. Эти методы вызывают строго типизированный ExecuteFunction для возврата типизированного ObjectResult<T>объекта . Дополнительные сведения см. в статье Код приложения с использованием хранимых процедур (Entity Framework).

Все параметры функции являются обязательными в массиве параметров, а все типы проверяются на соответствие метаданным функции импорта, включая тип самой функции. null Значения разрешены для типов значений CLR. Проверка параметров производится поставщиком.

Метод ExecuteFunction использует MergeOption значение AppendOnly. Таким образом, если объект уже существует в контексте объекта, он не будет загружен из источника данных.

См. также раздел

Применяется к

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

Выполняет данную хранимую процедуру или функцию, определенную в источнике данных и выраженную в концептуальной модели (с применением указанных параметров и команды слияния). Возвращает типизированный объект 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)

Параметры типа

TElement

Тип сущности объекта ObjectResult<T>, возвращаемого при выполнении функции в отношении источника данных. Данный тип должен реализовывать IEntityWithChangeTracker.

Параметры

functionName
String

Имя хранимой процедуры или функции. Имя может включать имя контейнера, например <Container Name>.<Function Name>. Если имя контейнера по умолчанию известно, требуется только имя функции.

mergeOption
MergeOption

Параметр MergeOption для использования при выполнении запроса.

parameters
ObjectParameter[]

Массив объектов ObjectParameter.

Возвращаемое значение

ObjectResult<TElement>

Объект ObjectResult<T> для данных, возвращенных хранимой процедурой.

Исключения

ArgumentException

Параметр function имеет значение null или пуст

-или-

function не найден.

InvalidOperationException

Средство чтения сущностей не поддерживает эту функцию function.

-или-

Несоответствие типов между средством чтения и функцией function.

Комментарии

Метод ExecuteFunction является вспомогательным методом, который используется для выполнения хранимых процедур или функций, определенных в источнике данных и выраженных в концептуальной модели. Средства entity Data Model создают метод для каждого элемента FunctionImport в концептуальной модели. Эти методы вызывают строго типизированный ExecuteFunction для возврата типизированного ObjectResult<T>объекта . Дополнительные сведения см. в статье Код приложения с использованием хранимых процедур (Entity Framework).

Все параметры функции являются обязательными в массиве параметров, а все типы проверяются на соответствие метаданным функции импорта, включая тип самой функции. null Значения разрешены для типов значений CLR. Проверка параметров производится поставщиком.

См. также раздел

Применяется к