EntityCommand Classe
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Representa um comando para a camada conceptual.
public ref class EntityCommand sealed : System::Data::Common::DbCommand
public sealed class EntityCommand : System.Data.Common.DbCommand
type EntityCommand = class
inherit DbCommand
Public NotInheritable Class EntityCommand
Inherits DbCommand
- Herança
Construtores
| Name | Description |
|---|---|
| EntityCommand() |
Inicializa uma nova instância da EntityCommand classe usando os valores especificados. |
| EntityCommand(String, EntityConnection, EntityTransaction) |
Inicializa uma nova instância da EntityCommand classe com a instrução, ligação e transação especificadas. |
| EntityCommand(String, EntityConnection) |
Inicializa uma nova instância da EntityCommand classe com a instrução e ligação especificadas. |
| EntityCommand(String) |
Inicializa uma nova instância da EntityCommand classe com a instrução especificada. |
Propriedades
| Name | Description |
|---|---|
| CanRaiseEvents |
Obtém um valor que indica se o componente pode gerar um evento. (Herdado de Component) |
| CommandText |
Recebe ou define uma instrução SQL Entity que especifica um comando ou procedimento armazenado a executar. |
| CommandTimeout |
Obtém ou define o tempo de espera antes de expirar. |
| CommandTree |
Obtém ou define a árvore de comandos para executar; apenas um da árvore de comandos ou do texto de comando pode ser definido, não ambos. |
| CommandType |
Obtém ou define um valor que indica como a CommandText propriedade deve ser interpretada. |
| Connection |
Obtém ou define o EntityConnection usado pelo EntityCommand. |
| Container |
Obtém o IContainer que contém o Component. (Herdado de Component) |
| DbConnection |
Obtém ou define o DbConnection usado por este DbCommand. (Herdado de DbCommand) |
| DbParameterCollection |
Fica com a coleção de DbParameter objetos. (Herdado de DbCommand) |
| DbTransaction |
Obtém ou define o DbTransaction dentro do qual este DbCommand objeto executa. (Herdado de DbCommand) |
| DesignMode |
Obtém um valor que indica se o Component está atualmente em modo de design. (Herdado de Component) |
| DesignTimeVisible |
Recebe ou define um valor que indica se o objeto de comando deve ser visível num controlo do Windows Form Designer. |
| EnablePlanCaching |
Recebe ou define um valor que indica se a cache do plano de consulta está ativada. |
| Events |
Obtém a lista de gestores de eventos que estão ligados a isto Component. (Herdado de Component) |
| Parameters |
Obtém os parâmetros da instrução SQL da Entidade ou procedimento armazenado. |
| Site |
Obtém ou define o ISite do Component. (Herdado de Component) |
| Transaction |
Obtém ou define a transação dentro da qual executa SqlCommand . |
| UpdatedRowSource |
Obtém ou define como os resultados dos comandos são aplicados às linhas a serem atualizadas. |
Métodos
| Name | Description |
|---|---|
| Cancel() |
Cancela a execução de um EntityCommand. |
| CreateDbParameter() |
Cria uma nova instância de um DbParameter objeto. (Herdado de DbCommand) |
| CreateObjRef(Type) |
Cria um objeto que contém toda a informação relevante necessária para gerar um proxy usado para comunicar com um objeto remoto. (Herdado de MarshalByRefObject) |
| CreateParameter() |
Cria uma nova instância de um EntityParameter objeto. |
| Equals(Object) |
Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object) |
| ExecuteDbDataReader(CommandBehavior) |
Executa o comando contra a sua ligação, devolvendo um DbDataReader que pode ser usado para aceder aos resultados. (Herdado de DbCommand) |
| ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken) |
Os fornecedores devem implementar este método para fornecer uma implementação não padrão para ExecuteReader sobrecargas. A implementação padrão invoca o método síncrono ExecuteReader() e devolve uma tarefa concluída, bloqueando a thread que chama. A implementação por defeito devolverá uma tarefa cancelada se for recebida um token de cancelamento já cancelado. As exceções lançadas pelo ExecuteReader serão comunicadas através da propriedade de Exceção de Tarefa devolvida. Este método aceita um token de cancelamento que pode ser usado para pedir que a operação seja cancelada antecipadamente. As implementações podem ignorar este pedido. (Herdado de DbCommand) |
| ExecuteNonQuery() |
Executa o comando atual. |
| ExecuteNonQueryAsync() |
Uma versão assíncrona de ExecuteNonQuery(), que executa o comando contra o seu objeto de ligação, devolvendo o número de linhas afetadas. Invoca ExecuteNonQueryAsync(CancellationToken) com CancellationToken.None. (Herdado de DbCommand) |
| ExecuteNonQueryAsync(CancellationToken) |
Esta é a versão assíncrona de ExecuteNonQuery(). Os prestadores devem sobrepor-se com uma implementação adequada. O token de cancelamento pode, opcionalmente, ser ignorado. A implementação padrão invoca o método síncrono ExecuteNonQuery() e devolve uma tarefa concluída, bloqueando a thread que chama. A implementação por defeito devolverá uma tarefa cancelada se for recebida um token de cancelamento já cancelado. As exceções lançadas por ExecuteNonQuery() serão comunicadas através da propriedade de Exceção de Tarefa devolvida. Não invoque outros métodos e propriedades do |
| ExecuteReader() |
Executa o comando e devolve um leitor de dados. |
| ExecuteReader(CommandBehavior) |
Compila o CommandText numa árvore de comandos e passa-o para o fornecedor de armazenamento subjacente para execução, depois constrói um EntityDataReader conjunto de resultados produzido usando o especificado CommandBehavior. |
| ExecuteReaderAsync() |
Uma versão assíncrona de ExecuteReader, que executa o comando contra a sua ligação, retornando a DbDataReader que pode ser usada para aceder aos resultados. Invoca ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken) com CancellationToken.None. (Herdado de DbCommand) |
| ExecuteReaderAsync(CancellationToken) |
Uma versão assíncrona de ExecuteReader, que executa o comando contra a sua ligação, retornando a DbDataReader que pode ser usada para aceder aos resultados. Invoca ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken). (Herdado de DbCommand) |
| ExecuteReaderAsync(CommandBehavior, CancellationToken) |
Invoca ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken). (Herdado de DbCommand) |
| ExecuteReaderAsync(CommandBehavior) |
Uma versão assíncrona de ExecuteReader, que executa o comando contra a sua ligação, retornando a DbDataReader que pode ser usada para aceder aos resultados. Invoca ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken). (Herdado de DbCommand) |
| ExecuteScalar() |
Executa o comando e retorna a primeira coluna da primeira linha do conjunto de resultados. Colunas ou linhas adicionais são ignoradas. |
| ExecuteScalarAsync() |
Uma versão assíncrona de ExecuteScalar(), que executa o comando e devolve a primeira coluna da primeira linha do primeiro conjunto de resultados devolvido. Todas as outras colunas, linhas e conjuntos de resultados são ignorados. Invoca ExecuteScalarAsync(CancellationToken) com CancellationToken.None. (Herdado de DbCommand) |
| ExecuteScalarAsync(CancellationToken) |
Esta é a versão assíncrona de ExecuteScalar(). Os prestadores devem sobrepor-se com uma implementação adequada. O token de cancelamento pode, opcionalmente, ser ignorado. A implementação padrão invoca o método síncrono ExecuteScalar() e devolve uma tarefa concluída, bloqueando a thread que chama. A implementação por defeito devolverá uma tarefa cancelada se for recebida um token de cancelamento já cancelado. As exceções lançadas pelo ExecuteScalar serão comunicadas através da propriedade de Exceção de Tarefa devolvida. Não invoque outros métodos e propriedades do |
| GetHashCode() |
Serve como função de hash predefinida. (Herdado de Object) |
| GetLifetimeService() |
Recupera o objeto de serviço de tempo de vida atual que controla a política de vida útil neste caso. (Herdado de MarshalByRefObject) |
| GetService(Type) |
Devolve um objeto que representa um serviço fornecido pelo Component ou pelo seu Container. (Herdado de Component) |
| GetType() |
Obtém o Type da instância atual. (Herdado de Object) |
| InitializeLifetimeService() |
Obtém-se um objeto de serviço vitalício para controlar a apólice vitalícia neste caso. (Herdado de MarshalByRefObject) |
| MemberwiseClone() |
Cria uma cópia superficial do atual Object. (Herdado de Object) |
| MemberwiseClone(Boolean) |
Cria uma cópia superficial do objeto atual MarshalByRefObject . (Herdado de MarshalByRefObject) |
| Prepare() |
Compila o comando ao nível da entidade e cria uma versão preparada do comando. |
| ToString() |
Devolve a String contendo o nome do Component, se existir. Este método não deve ser ultrapassado. (Herdado de Component) |
| ToTraceString() |
Compila o comando ao nível da entidade e devolve o texto do comando armazenar. |
evento
| Name | Description |
|---|---|
| Disposed |
Ocorre quando o componente é eliminado por uma chamada ao Dispose() método. (Herdado de Component) |
Implementações de Interface Explícita
| Name | Description |
|---|---|
| IDbCommand.Connection |
Obtém ou define o IDbConnection usado por esta instância do IDbCommand. (Herdado de DbCommand) |
| IDbCommand.CreateParameter() |
Cria uma nova instância de um IDbDataParameter objeto. (Herdado de DbCommand) |
| IDbCommand.ExecuteReader() |
Executa o CommandText contra o Connection e constrói um IDataReader. (Herdado de DbCommand) |
| IDbCommand.ExecuteReader(CommandBehavior) |
Executa o CommandText contra o Connection, e constrói um IDataReader usando um dos CommandBehavior valores. (Herdado de DbCommand) |
| IDbCommand.Parameters |
Obtém o IDataParameterCollection. (Herdado de DbCommand) |
| IDbCommand.Transaction |
Obtém ou define o DbTransaction dentro do qual este DbCommand objeto executa. (Herdado de DbCommand) |