ObjectContext.ExecuteFunction Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Sobrecargas
| Nombre | Description |
|---|---|
| ExecuteFunction(String, ObjectParameter[]) |
Ejecuta un procedimiento almacenado o una función que se define en el origen de datos y se expresa en el modelo conceptual; descarta los resultados devueltos de la función; y devuelve el número de filas afectadas por la ejecución. |
| ExecuteFunction<TElement>(String, ObjectParameter[]) |
Ejecuta un procedimiento almacenado o una función que se define en el origen de datos y se asigna en el modelo conceptual, con los parámetros especificados. Devuelve un objeto con ObjectResult<T>tipo . |
| ExecuteFunction<TElement>(String, MergeOption, ObjectParameter[]) |
Ejecuta el procedimiento almacenado o la función especificados que se definen en el origen de datos y se expresan en el modelo conceptual, con los parámetros especificados y la opción de combinación. Devuelve un objeto con ObjectResult<T>tipo . |
ExecuteFunction(String, ObjectParameter[])
Ejecuta un procedimiento almacenado o una función que se define en el origen de datos y se expresa en el modelo conceptual; descarta los resultados devueltos de la función; y devuelve el número de filas afectadas por la ejecución.
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 IntegerParámetros
- functionName
- String
Nombre del procedimiento almacenado o la función. El nombre puede incluir el nombre del contenedor, como <Container Name>.<Function Name>. Cuando se conoce el nombre de contenedor predeterminado, solo se requiere el nombre de la función.
- parameters
- ObjectParameter[]
Una matriz de objetos ObjectParameter.
Devoluciones
Número de filas afectadas.
Excepciones
El lector de entidades no admite este functionName.
O bien
Hay un error de coincidencia de tipos en el lector y en la función .
Se aplica a
ExecuteFunction<TElement>(String, ObjectParameter[])
Ejecuta un procedimiento almacenado o una función que se define en el origen de datos y se asigna en el modelo conceptual, con los parámetros especificados. Devuelve un objeto con ObjectResult<T>tipo .
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)Parámetros de tipo
- TElement
Tipo de entidad del ObjectResult<T> devuelto cuando se ejecuta la función en el origen de datos. Este tipo debe implementar IEntityWithChangeTracker.
Parámetros
- functionName
- String
Nombre del procedimiento almacenado o la función. El nombre puede incluir el nombre del contenedor, como <Container Name>.<Function Name>. Cuando se conoce el nombre de contenedor predeterminado, solo se requiere el nombre de la función.
- parameters
- ObjectParameter[]
Una matriz de objetos ObjectParameter.
Devoluciones
para ObjectResult<T> los datos devueltos por el procedimiento almacenado.
Excepciones
El lector de entidades no admite esta función.
O bien
Hay un error de coincidencia de tipos en el lector y en la función .
Comentarios
El ExecuteFunction método es un método auxiliar que se usa para ejecutar procedimientos almacenados o funciones definidos en el origen de datos y expresados en el modelo conceptual. Las herramientas entity Data Model generan un método para cada elemento FunctionImport en el modelo conceptual. Estos métodos llaman a un fuertemente tipado ExecuteFunction para devolver un con ObjectResult<T>tipo .
Todos los parámetros de la función son necesarios en la matriz de parámetros y todos los tipos se comprueban con los metadatos de la función de importación, incluido el tipo de la propia función.
null Se permiten valores para los tipos de valor CLR. El proveedor realiza la validación de parámetros.
El ExecuteFunction método usa el MergeOption valor de AppendOnly. Por lo tanto, si ya existe un objeto en el contexto del objeto, no se cargará desde el origen de datos.
Consulte también
Se aplica a
ExecuteFunction<TElement>(String, MergeOption, ObjectParameter[])
Ejecuta el procedimiento almacenado o la función especificados que se definen en el origen de datos y se expresan en el modelo conceptual, con los parámetros especificados y la opción de combinación. Devuelve un objeto con ObjectResult<T>tipo .
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)Parámetros de tipo
- TElement
Tipo de entidad del ObjectResult<T> devuelto cuando se ejecuta la función en el origen de datos. Este tipo debe implementar IEntityWithChangeTracker.
Parámetros
- functionName
- String
Nombre del procedimiento almacenado o la función. El nombre puede incluir el nombre del contenedor, como <Container Name>.<Function Name>. Cuando se conoce el nombre de contenedor predeterminado, solo se requiere el nombre de la función.
- mergeOption
- MergeOption
que MergeOption se va a usar al ejecutar la consulta.
- parameters
- ObjectParameter[]
Una matriz de objetos ObjectParameter.
Devoluciones
para ObjectResult<T> los datos devueltos por el procedimiento almacenado.
Excepciones
El lector de entidades no admite esta función.
O bien
Hay un error de coincidencia de tipos en el lector y en la función .
Comentarios
El ExecuteFunction método es un método auxiliar que se usa para ejecutar procedimientos almacenados o funciones definidos en el origen de datos y expresados en el modelo conceptual. Las herramientas entity Data Model generan un método para cada elemento FunctionImport en el modelo conceptual. Estos métodos llaman a un fuertemente tipado ExecuteFunction para devolver un con ObjectResult<T>tipo .
Todos los parámetros de la función son necesarios en la matriz de parámetros y todos los tipos se comprueban con los metadatos de la función de importación, incluido el tipo de la propia función.
null Se permiten valores para los tipos de valor CLR. El proveedor realiza la validación de parámetros.
