ObjectContext.ExecuteFunction Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Sobrecargas
| Nome | Description |
|---|---|
| ExecuteFunction(String, ObjectParameter[]) |
Executa um procedimento ou função armazenado definido na fonte de dados e expresso no modelo conceitual; descarta todos os resultados retornados da função; e retorna o número de linhas afetadas pela execução. |
| ExecuteFunction<TElement>(String, ObjectParameter[]) |
Executa um procedimento ou função armazenado definido na fonte de dados e mapeado no modelo conceitual, com os parâmetros especificados. Retorna um tipo ObjectResult<T>. |
| ExecuteFunction<TElement>(String, MergeOption, ObjectParameter[]) |
Executa o procedimento ou função armazenado especificado definido na fonte de dados e expresso no modelo conceitual, com os parâmetros especificados e a opção de mesclagem. Retorna um tipo ObjectResult<T>. |
ExecuteFunction(String, ObjectParameter[])
Executa um procedimento ou função armazenado definido na fonte de dados e expresso no modelo conceitual; descarta todos os resultados retornados da função; e retorna 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[] -> intPublic Function ExecuteFunction (functionName As String, ParamArray parameters As ObjectParameter()) As IntegerParâmetros
- functionName
- String
O nome do procedimento ou função armazenado. O nome pode incluir o nome do contêiner, como <Container Name>.<Function Name>. Quando o nome do contêiner padrão é conhecido, somente o nome da função é necessário.
- parameters
- ObjectParameter[]
Uma matriz de objetos ObjectParameter.
Retornos
O número de linhas afetadas.
Exceções
O leitor de entidade não dá suporte a isso functionName.
- ou -
Há uma incompatibilidade de tipo no leitor e na função.
Aplica-se a
ExecuteFunction<TElement>(String, ObjectParameter[])
Executa um procedimento ou função armazenado definido na fonte de dados e mapeado no modelo conceitual, com os parâmetros especificados. Retorna um tipo 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
- 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 do procedimento ou função armazenado. O nome pode incluir o nome do contêiner, como <Container Name>.<Function Name>. Quando o nome do contêiner padrão é conhecido, somente o nome da função é necessário.
- parameters
- ObjectParameter[]
Uma matriz de objetos ObjectParameter.
Retornos
Um ObjectResult<T> para os dados retornados pelo procedimento armazenado.
Exceções
O leitor de entidade não dá suporte a essa função.
- ou -
Há uma incompatibilidade de tipo no leitor e na função.
Comentários
O ExecuteFunction método é um método auxiliar usado para executar procedimentos armazenados ou funções definidas na fonte de dados e expressas 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 tipo ObjectResult<T>.
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
Aplica-se a
ExecuteFunction<TElement>(String, MergeOption, ObjectParameter[])
Executa o procedimento ou função armazenado especificado definido na fonte de dados e expresso no modelo conceitual, com os parâmetros especificados e a opção de mesclagem. Retorna um tipo 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
- 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 do procedimento ou função armazenado. O nome pode incluir o nome do contêiner, como <Container Name>.<Function Name>. Quando o nome do contêiner padrão é conhecido, somente o nome da função é necessário.
- mergeOption
- MergeOption
O MergeOption a ser usado ao executar a consulta.
- parameters
- ObjectParameter[]
Uma matriz de objetos ObjectParameter.
Retornos
Um ObjectResult<T> para os dados retornados pelo procedimento armazenado.
Exceções
O leitor de entidade não dá suporte a essa função.
- ou -
Há uma incompatibilidade de tipo no leitor e na função.
Comentários
O ExecuteFunction método é um método auxiliar usado para executar procedimentos armazenados ou funções definidas na fonte de dados e expressas 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 tipo ObjectResult<T>.
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.
