ObjectContext.ExecuteFunction Método

Definição

Namespace:

System.Data.Objects

Assembly:

System.Data.Entity.dll

Sobrecargas

ExecuteFunction(String, ObjectParameter[])	Executa um procedimento armazenado ou uma função definida na fonte de dados e expressa no modelo conceitual, descarta os resultados retornados da função e retorna o número de linhas afetado pela execução.
ExecuteFunction<TElement>(String, ObjectParameter[])	Executa uma função ou procedimento armazenado definido na fonte de dados e mapeado no modelo conceitual, com os parâmetros especificados. Retorna um ObjectResult<T> tipado.
ExecuteFunction<TElement>(String, MergeOption, ObjectParameter[])	Executa uma função ou procedimento armazenado determinados, definidos na fonte de dados e expressos no modelo conceitual com os parâmetros especificados e opção de mesclagem. Retorna um ObjectResult<T> tipado.

ExecuteFunction(String, ObjectParameter[])

Executa um procedimento armazenado ou uma função definida na fonte de dados e expressa no modelo conceitual, descarta os resultados retornados da função e retorna o número de linhas afetado 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 da função ou do procedimento armazenado. O nome pode incluir o nome do contêiner, como <Nome> do Contêiner.< Nome> da função. Quando o nome do contêiner padrão é conhecido, apenas o nome da função é necessário.

parameters

ObjectParameter[]

Uma matriz de objetos de ObjectParameter.

Retornos

Int32

O número de linhas afetadas.

Exceções

ArgumentException

function é nulo ou vazio

- ou -

function não foi encontrado.

InvalidOperationException

O leitor de entidade não dá suporte a este function.

- ou -

Há tipos incompatíveis no leitor e no function.

ExecuteFunction<TElement>(String, ObjectParameter[])

Executa uma função ou procedimento armazenado definido na fonte de dados e mapeado no modelo conceitual, com os parâmetros especificados. Retorna um ObjectResult<T> tipado.

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

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

Parâmetros

functionName

String

O nome da função ou do procedimento armazenado. O nome pode incluir o nome do contêiner, como <Nome> do Contêiner.< Nome> da função. Quando o nome do contêiner padrão é conhecido, apenas o nome da função é necessário.

parameters

ObjectParameter[]

Uma matriz de objetos de ObjectParameter.

Retornos

ObjectResult<TElement>

Um ObjectResult<T> para os dados retornados pelo procedimento armazenado.

Exceções

ArgumentException

function é nulo ou vazio

- ou -

function não foi encontrado.

InvalidOperationException

O leitor de entidade não dá suporte a este function.

- ou -

Há tipos incompatíveis no leitor e no function.

Comentários

O ExecuteFunction método é um método auxiliar usado para executar procedimentos armazenados ou funções que são definidos na fonte de dados e expressos no modelo conceitual. As ferramentas do Modelo de Dados de Entidade geram um método para cada Elemento FunctionImport no modelo conceitual. Esses métodos chamam um fortemente tipado ExecuteFunction para retornar um tipado ObjectResult<T>. Para obter mais informações, consulte o Código do Aplicativo usando procedimentos armazenados (Entity Framework).

Todos os parâmetros para a função são necessários na matriz de parâmetros e todos os tipos são verificados nos metadados da função de importação, incluindo o tipo da própria função. null os valores são permitidos para tipos de valor CLR. A validação de parâmetro é executada pelo provedor.

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

Confira também

• Trabalhando com objetos (Entity Framework)

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

Executa uma função ou procedimento armazenado determinados, definidos na fonte de dados e expressos no modelo conceitual com os parâmetros especificados e opção de mesclagem. Retorna um ObjectResult<T> tipado.

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

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

Parâmetros

functionName

String

O nome da função ou do procedimento armazenado. O nome pode incluir o nome do contêiner, como <Nome> do Contêiner.< Nome> da função. Quando o nome do contêiner padrão é conhecido, apenas o nome da função é necessário.

mergeOption

MergeOption

O MergeOption para usar ao executar a consulta.

parameters

ObjectParameter[]

Uma matriz de objetos de ObjectParameter.

Retornos

ObjectResult<TElement>

Um ObjectResult<T> para os dados retornados pelo procedimento armazenado.

Exceções

ArgumentException

function é nulo ou vazio

- ou -

function não foi encontrado.

InvalidOperationException

O leitor de entidade não dá suporte a este function.

- ou -

Há tipos incompatíveis no leitor e no function.

Comentários

O ExecuteFunction método é um método auxiliar que é usado para executar procedimentos armazenados ou funções que são definidos na fonte de dados e expressos no modelo conceitual. As ferramentas do Modelo de Dados de Entidade geram um método para cada Elemento FunctionImport no modelo conceitual. Esses métodos chamam um fortemente tipado ExecuteFunction para retornar um tipado ObjectResult<T>. Para obter mais informações, consulte o Código do Aplicativo usando procedimentos armazenados (Entity Framework).

Todos os parâmetros para a função são necessários na matriz de parâmetros e todos os tipos são verificados nos metadados da função de importação, incluindo o tipo da própria função. null os valores são permitidos para tipos de valor CLR. A validação de parâmetro é executada pelo provedor.

Confira também

• Trabalhando com objetos (Entity Framework)