ObjectContext.ExecuteFunction Método

  • Referencia

Definición

Espacio de nombres:
System.Data.Objects
Ensamblado:
System.Data.Entity.dll

Sobrecargas

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 cualquier resultado devuelto 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 ObjectResult<T> con tipo.
ExecuteFunction<TElement>(String, MergeOption, ObjectParameter[])

Ejecuta la función o el procedimiento almacenado especificado que se define en el origen de datos y se expresa en el modelo conceptual, con los parámetros y la opción de combinación especificados. Devuelve un objeto ObjectResult<T> con 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 cualquier resultado devuelto 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[] -> int
Public Function ExecuteFunction (functionName As String, ParamArray parameters As ObjectParameter()) As Integer

Parámetros

functionName
String

Nombre del procedimiento almacenado o de la función. El nombre puede incluir el nombre del contenedor, como <Container Name>.<Function Name>. Cuando se conoce el nombre del contenedor predeterminado, solo se requiere el nombre de la función.

parameters
ObjectParameter[]

Matriz de objetos ObjectParameter.

Devoluciones

Int32

El número de filas afectadas.

Excepciones

ArgumentException

El parámetro function es null o está vacío.

o bien

No se ha encontrado function.

InvalidOperationException

El lector de entidades no admite este parámetro function.

o bien

No coinciden los tipos en el lector y el parámetro function.

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 ObjectResult<T> con 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 valor ObjectResult<T> devuelto cuando la función se ejecuta en el origen de datos. Este tipo debe implementar IEntityWithChangeTracker.

Parámetros

functionName
String

Nombre del procedimiento almacenado o de la función. El nombre puede incluir el nombre del contenedor, como <Container Name>.<Function Name>. Cuando se conoce el nombre del contenedor predeterminado, solo se requiere el nombre de la función.

parameters
ObjectParameter[]

Matriz de objetos ObjectParameter.

Devoluciones

ObjectResult<TElement>

ObjectResult<T> para los datos devueltos por el procedimiento almacenado.

Excepciones

ArgumentException

El parámetro function es null o está vacío.

o bien

No se ha encontrado function.

InvalidOperationException

El lector de entidades no admite este parámetro function.

o bien

No coinciden los tipos en el lector y el parámetro function.

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 . Para obtener más información, consulte Código de aplicación mediante procedimientos almacenados (Entity Framework).

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 la función o el procedimiento almacenado especificado que se define en el origen de datos y se expresa en el modelo conceptual, con los parámetros y la opción de combinación especificados. Devuelve un objeto ObjectResult<T> con 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 valor ObjectResult<T> devuelto cuando la función se ejecuta en el origen de datos. Este tipo debe implementar IEntityWithChangeTracker.

Parámetros

functionName
String

Nombre del procedimiento almacenado o de la función. El nombre puede incluir el nombre del contenedor, como <Container Name>.<Function Name>. Cuando se conoce el nombre del contenedor predeterminado, solo se requiere el nombre de la función.

mergeOption
MergeOption

MergeOption que se debe usar al ejecutar la consulta.

parameters
ObjectParameter[]

Matriz de objetos ObjectParameter.

Devoluciones

ObjectResult<TElement>

ObjectResult<T> para los datos devueltos por el procedimiento almacenado.

Excepciones

ArgumentException

El parámetro function es null o está vacío.

o bien

No se ha encontrado function.

InvalidOperationException

El lector de entidades no admite este parámetro function.

o bien

No coinciden los tipos en el lector y el parámetro function.

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 . Para obtener más información, consulte Código de aplicación mediante procedimientos almacenados (Entity Framework).

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.

Consulte también

Se aplica a