ObjectContext.ExecuteFunction Método

Definição

Espaço de Nomes:
System.Data.Objects
Assemblagem:
System.Data.Entity.dll

Sobrecargas

Name Description
ExecuteFunction(String, ObjectParameter[])

Executa um procedimento ou função armazenada que está definida na fonte de dados e expressa no modelo conceptual; descarta quaisquer resultados devolvidos da função; e devolve o número de linhas afetadas pela execução.
ExecuteFunction<TElement>(String, ObjectParameter[])

Executa um procedimento ou função armazenada definida na fonte de dados e mapeada no modelo conceptual, com os parâmetros especificados. Devolve um arquivo digitado ObjectResult<T>.
ExecuteFunction<TElement>(String, MergeOption, ObjectParameter[])

Executa o procedimento ou função armazenada definida na fonte de dados e expressa no modelo conceptual, com os parâmetros especificados e a opção de fusão. Devolve um arquivo digitado ObjectResult<T>.

ExecuteFunction(String, ObjectParameter[])

Executa um procedimento ou função armazenada que está definida na fonte de dados e expressa no modelo conceptual; descarta quaisquer resultados devolvidos da função; e devolve o número de linhas afetadas pela execução.

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

O nome do procedimento ou função armazenada. O nome pode incluir o nome do contentor, como <Container Name>.<Function Name>. Quando o nome padrão do contentor é conhecido, apenas o nome da função é necessário.

parameters
ObjectParameter[]

Uma variedade de ObjectParameter objetos.

Devoluções

Int32

O número de linhas afetadas.

Exceções

ArgumentException

functionName é nulo ou vazio.

-ou-

functionName não foi encontrado.

InvalidOperationException

O leitor de entidades não suporta esta functionNameinformação.

-ou-

Existe uma incompatibilidade de tipos entre o leitor e a função.

Aplica-se a

ExecuteFunction<TElement>(String, ObjectParameter[])

Executa um procedimento ou função armazenada definida na fonte de dados e mapeada no modelo conceptual, com os parâmetros especificados. Devolve um arquivo digitado 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)

Parâmetros de Tipo Genérico

TElement

O tipo de entidade do ObjectResult<T> retornado quando a função é executada contra a fonte de dados. Este tipo deve implementar IEntityWithChangeTracker.

Parâmetros

functionName
String

O nome do procedimento ou função armazenada. O nome pode incluir o nome do contentor, como <Container Name>.<Function Name>. Quando o nome padrão do contentor é conhecido, apenas o nome da função é necessário.

parameters
ObjectParameter[]

Uma variedade de ObjectParameter objetos.

Devoluções

ObjectResult<TElement>

E ObjectResult<T> para os dados que são devolvidos pelo procedimento armazenado.

Exceções

ArgumentException

functionName é nulo ou vazio

-ou-

functionName não foi encontrado.

InvalidOperationException

O leitor de entidades não suporta esta função.

-ou-

Existe uma incompatibilidade de tipos entre o leitor e a função.

Observações

O ExecuteFunction método é um método auxiliar utilizado para executar procedimentos ou funções armazenadas que são definidas na fonte de dados e expressas no modelo conceptual. As ferramentas do Entity Data Model geram um método para cada Elemento FunctionImport no modelo conceptual. Estes métodos chamam um strongly-typed ExecuteFunction para devolver um tipado ObjectResult<T>. Para mais informações, consulte Código de Aplicação usando Procedimentos Armazenados (Entity Framework).

Todos os parâmetros da função são necessários no array de parâmetros e todos os tipos são verificados em relação aos metadados da função de importação, incluindo o tipo da própria função. null são permitidos valores para tipos de valores CLR. A validação dos parâmetros é realizada pelo fornecedor.

O ExecuteFunction método utiliza o MergeOption valor de AppendOnly. Portanto, se um objeto já existir no contexto do objeto, não será carregado a partir da fonte de dados.

Ver também

Aplica-se a

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

Executa o procedimento ou função armazenada definida na fonte de dados e expressa no modelo conceptual, com os parâmetros especificados e a opção de fusão. Devolve um arquivo digitado 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)

Parâmetros de Tipo Genérico

TElement

O tipo de entidade do ObjectResult<T> retornado quando a função é executada contra a fonte de dados. Este tipo deve implementar IEntityWithChangeTracker.

Parâmetros

functionName
String

O nome do procedimento ou função armazenada. O nome pode incluir o nome do contentor, como <Container Name>.<Function Name>. Quando o nome padrão do contentor é conhecido, apenas o nome da função é necessário.

mergeOption
MergeOption

A MergeOption usar ao executar a consulta.

parameters
ObjectParameter[]

Uma variedade de ObjectParameter objetos.

Devoluções

ObjectResult<TElement>

E ObjectResult<T> para os dados que são devolvidos pelo procedimento armazenado.

Exceções

ArgumentException

functionName é nulo ou vazio

-ou-

functionName não foi encontrado.

InvalidOperationException

O leitor de entidades não suporta esta função.

-ou-

Existe uma incompatibilidade de tipos entre o leitor e a função.

Observações

O ExecuteFunction método é um método auxiliar utilizado para executar procedimentos ou funções armazenadas definidas na fonte de dados e expressas num modelo conceptual. As ferramentas do Entity Data Model geram um método para cada Elemento FunctionImport no modelo conceptual. Estes métodos chamam um strongly-typed ExecuteFunction para devolver um tipado ObjectResult<T>. Para mais informações, consulte Código de Aplicação usando Procedimentos Armazenados (Entity Framework).

Todos os parâmetros da função são necessários no array de parâmetros e todos os tipos são verificados em relação aos metadados da função de importação, incluindo o tipo da própria função. null são permitidos valores para tipos de valores CLR. A validação dos parâmetros é realizada pelo fornecedor.

Ver também

Aplica-se a