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

functionName имеет значение NULL или пусто.

–или–

functionName не найден.

InvalidOperationException

Средство чтения сущностей не поддерживает это functionName.

–или–

Существует несоответствие типов для средства чтения и функции.

ExecuteFunction<TElement>(String, ObjectParameter[])

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

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)

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

TElement

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

Параметры

functionName

String

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

parameters

ObjectParameter[]

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

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

ObjectResult<TElement>

Значение ObjectResult<T> для данных, возвращаемых хранимой процедурой.

Исключения

ArgumentException

functionName имеет значение NULL или пусто

–или–

functionName не найден.

InvalidOperationException

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

–или–

Существует несоответствие типов для средства чтения и функции.

Комментарии

Этот ExecuteFunction метод является вспомогательным методом, который используется для выполнения хранимых процедур или функций, определенных в источнике данных и выраженных в концептуальной модели. Средства модели данных сущности создают метод для каждого элемента FunctionImport в концептуальной модели. Эти методы вызывают строго типизированный ExecuteFunction для возврата типизированного ObjectResult<T>объекта.

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

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

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

• Работа с объектами (Entity Framework)

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

functionName имеет значение NULL или пусто

–или–

functionName не найден.

InvalidOperationException

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

–или–

Существует несоответствие типов для средства чтения и функции.

Комментарии

Этот ExecuteFunction метод является вспомогательным методом, который используется для выполнения хранимых процедур или функций, определенных в источнике данных и выраженных в концептуальной модели. Средства модели данных сущности создают метод для каждого элемента FunctionImport в концептуальной модели. Эти методы вызывают строго типизированный ExecuteFunction для возврата типизированного ObjectResult<T>объекта.

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

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

• Работа с объектами (Entity Framework)