ObjectContext.ExecuteFunction Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Перегрузки
| 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[] -> intPublic Function ExecuteFunction (functionName As String, ParamArray parameters As ObjectParameter()) As IntegerПараметры
- functionName
- String
Имя хранимой процедуры или функции. Имя может включать имя контейнера, например <Container Name>.<Function Name>. Если имя контейнера по умолчанию известно, требуется только имя функции.
- parameters
- ObjectParameter[]
Массив объектов ObjectParameter.
Возвращаемое значение
Число обработанных строк.
Исключения
Средство чтения сущностей не поддерживает эту функцию 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<T> для данных, возвращенных хранимой процедурой.
Исключения
Средство чтения сущностей не поддерживает эту функцию function.
-или-
Несоответствие типов между средством чтения и функцией function.
Комментарии
Метод ExecuteFunction является вспомогательным методом, который используется для выполнения хранимых процедур или функций, определенных в источнике данных и выраженных в концептуальной модели. Средства модели данных сущности создают метод для каждого элемента 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<T> для данных, возвращенных хранимой процедурой.
Исключения
Средство чтения сущностей не поддерживает эту функцию function.
-или-
Несоответствие типов между средством чтения и функцией function.
Комментарии
Метод ExecuteFunction является вспомогательным методом, который используется для выполнения хранимых процедур или функций, определенных в источнике данных и выраженных в концептуальной модели. Средства модели данных сущности создают метод для каждого элемента FunctionImport в концептуальной модели. Эти методы вызывают строго типизированный ExecuteFunction для возврата типизированного ObjectResult<T>объекта . Дополнительные сведения см. в статье Код приложения с использованием хранимых процедур (Entity Framework).
Все параметры функции необходимы в массиве параметров, а все типы проверяются на соответствие метаданным функции импорта, включая тип самой функции. null значения разрешены для типов значений CLR. Проверка параметров производится поставщиком.
См. также раздел
Применяется к
Обратная связь
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделе https://aka.ms/ContentUserFeedback.
Отправить и просмотреть отзыв по