DbCommand Classe

Definição

Namespace:

System.Data.Common

Assembly:

System.Data.Common.dll

Origem:

DbCommand.cs

Representa uma instrução SQL ou um procedimento armazenado a ser executado em uma fonte de dados. Fornece uma classe base para classes específicas do banco de dados que representam comandos. ExecuteNonQueryAsync.

public ref class DbCommand abstract : System::ComponentModel::Component, IAsyncDisposable, IDisposable, System::Data::IDbCommand

public abstract class DbCommand : System.ComponentModel.Component, IAsyncDisposable, IDisposable, System.Data.IDbCommand

type DbCommand = class
    inherit Component
    interface IDbCommand
    interface IDisposable
    interface IAsyncDisposable

Public MustInherit Class DbCommand
Inherits Component
Implements IAsyncDisposable, IDbCommand, IDisposable

Herança

Object

MarshalByRefObject

Component

DbCommand

Derivado

System.Data.EntityClient.EntityCommand

System.Data.Odbc.OdbcCommand

System.Data.OleDb.OleDbCommand

System.Data.SqlClient.SqlCommand

Implementações

IDisposable IDbCommand IAsyncDisposable

Construtores

DbCommand()

Constrói uma instância do objeto DbCommand.

Propriedades

CanRaiseEvents	Obtém um valor que indica se o componente pode gerar um evento. (Herdado de Component)
CommandText	Obtém ou define o comando de texto a ser executado na fonte de dados.
CommandTimeout	Obtém ou define o tempo de espera (em segundos) antes de encerrar a tentativa de executar o comando e gerar um erro.
CommandType	Obtém ou define como a propriedade CommandText é interpretada.
Connection	Obtém ou define o DbConnection usado por este DbCommand.
Container	Obtém o IContainer que contém o Component. (Herdado de Component)
DbConnection	Obtém ou define o DbConnection usado por este DbCommand.
DbParameterCollection	Obtém a coleção de objetos DbParameter.
DbTransaction	Obtém ou define o DbTransaction no qual esse objeto DbCommand é executado.
DesignMode	Obtém um valor que indica se o Component está atualmente no modo de design. (Herdado de Component)
DesignTimeVisible	Obtém ou define um valor que indica se o objeto de comando deve estar visível em um controle de interface personalizado.
Events	Obtém a lista de manipuladores de eventos anexados a este Component. (Herdado de Component)
Parameters	Obtém a coleção de objetos DbParameter. Para obter mais informações sobre parâmetros, consulte Configurando parâmetros e tipos de dados de parâmetro.
Site	Obtém ou define o ISite do Component. (Herdado de Component)
Transaction	Obtém ou define o DbTransaction no qual esse objeto DbCommand é executado.
UpdatedRowSource	Obtém ou define como os resultados do comando são aplicados ao DataRow quando usados pelo método Update de um DbDataAdapter.

Métodos

Cancel()	Tenta cancelar a execução de um DbCommand.
CreateDbParameter()	Cria uma nova instância de um objeto DbParameter.
CreateObjRef(Type)	Cria um objeto que contém todas as informações relevantes necessárias para gerar um proxy usado para se comunicar com um objeto remoto. (Herdado de MarshalByRefObject)
CreateParameter()	Cria uma nova instância de um objeto DbParameter.
Dispose()	Libera todos os recursos usados pelo Component. (Herdado de Component)
Dispose(Boolean)	Libera os recursos não gerenciados usados pelo Component e, opcionalmente, libera os recursos gerenciados. (Herdado de Component)
DisposeAsync()	Mergulha de forma assíncrona o objeto de comando.
Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
ExecuteDbDataReader(CommandBehavior)	Executa o comando em relação à sua conexão, retornando um DbDataReader que pode ser usado para acessar os resultados.
ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken)	Os provedores devem implementar esse método para fornecer uma implementação não padrão para sobrecargas de ExecuteReader. A implementação padrão invoca o método de ExecuteReader() síncrono e retorna uma tarefa concluída, bloqueando o thread de chamada. A implementação padrão retornará uma tarefa cancelada se passar um token de cancelamento já cancelado. As exceções geradas pelo ExecuteReader serão comunicadas por meio da propriedade de Exceção de Tarefa retornada. Esse método aceita um token de cancelamento que pode ser usado para solicitar que a operação seja cancelada antecipadamente. As implementações podem ignorar essa solicitação.
ExecuteNonQuery()	Executa o comando em relação ao objeto de conexão, retornando o número de linhas afetadas.
ExecuteNonQueryAsync()	Uma versão assíncrona do ExecuteNonQuery(), que executa o comando em relação ao objeto de conexão, retornando o número de linhas afetadas. Invoca ExecuteNonQueryAsync(CancellationToken) com CancellationToken.None.
ExecuteNonQueryAsync(CancellationToken)	Esta é a versão assíncrona do ExecuteNonQuery(). Os provedores devem substituir com uma implementação apropriada. Opcionalmente, o token de cancelamento pode ser ignorado. A implementação padrão invoca o método de ExecuteNonQuery() síncrono e retorna uma tarefa concluída, bloqueando o thread de chamada. A implementação padrão retornará uma tarefa cancelada se passar um token de cancelamento já cancelado. As exceções geradas por ExecuteNonQuery() serão comunicadas por meio da propriedade de Exceção de Tarefa retornada. Não invoque outros métodos e propriedades do objeto DbCommand até que a Tarefa retornada seja concluída.
ExecuteReader()	Executa o comando em relação à sua conexão, retornando um DbDataReader que pode ser usado para acessar os resultados.
ExecuteReader(CommandBehavior)	Executa o comando em relação à sua conexão, retornando um DbDataReader que pode ser usado para acessar os resultados.
ExecuteReaderAsync()	Uma versão assíncrona do ExecuteReader, que executa o comando em relação à sua conexão, retornando um DbDataReader que pode ser usado para acessar os resultados. Invoca ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken) com CancellationToken.None.
ExecuteReaderAsync(CancellationToken)	Uma versão assíncrona do ExecuteReader, que executa o comando em relação à sua conexão, retornando um DbDataReader que pode ser usado para acessar os resultados. Invoca ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken).
ExecuteReaderAsync(CommandBehavior)	Uma versão assíncrona do ExecuteReader, que executa o comando em relação à sua conexão, retornando um DbDataReader que pode ser usado para acessar os resultados. Invoca ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken).
ExecuteReaderAsync(CommandBehavior, CancellationToken)	Invoca ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken).
ExecuteScalar()	Executa o comando e retorna a primeira coluna da primeira linha no primeiro conjunto de resultados retornado. Todas as outras colunas, linhas e conjuntos de resultados são ignorados.
ExecuteScalarAsync()	Uma versão assíncrona do ExecuteScalar(), que executa o comando e retorna a primeira coluna da primeira linha no primeiro conjunto de resultados retornado. Todas as outras colunas, linhas e conjuntos de resultados são ignorados. Invoca ExecuteScalarAsync(CancellationToken) com CancellationToken.None.
ExecuteScalarAsync(CancellationToken)	Esta é a versão assíncrona do ExecuteScalar(). Os provedores devem substituir com uma implementação apropriada. Opcionalmente, o token de cancelamento pode ser ignorado. A implementação padrão invoca o método de ExecuteScalar() síncrono e retorna uma tarefa concluída, bloqueando o thread de chamada. A implementação padrão retornará uma tarefa cancelada se passar um token de cancelamento já cancelado. As exceções geradas pelo ExecuteScalar serão comunicadas por meio da propriedade de Exceção de Tarefa retornada. Não invoque outros métodos e propriedades do objeto DbCommand até que a Tarefa retornada seja concluída.
GetHashCode()	Serve como a função de hash padrão. (Herdado de Object)
GetLifetimeService()	Obsoleto. Recupera o objeto de serviço de tempo de vida atual que controla a política de tempo de vida para essa instância. (Herdado de MarshalByRefObject)
GetService(Type)	Retorna um objeto que representa um serviço fornecido pelo Component ou por seu Container. (Herdado de Component)
GetType()	Obtém o Type da instância atual. (Herdado de Object)
InitializeLifetimeService()	Obsoleto. Obtém um objeto de serviço de tempo de vida para controlar a política de tempo de vida dessa instância. (Herdado de MarshalByRefObject)
MemberwiseClone()	Cria uma cópia superficial do Objectatual. (Herdado de Object)
MemberwiseClone(Boolean)	Cria uma cópia superficial do objeto MarshalByRefObject atual. (Herdado de MarshalByRefObject)
Prepare()	Cria uma versão preparada (ou compilada) do comando na fonte de dados.
PrepareAsync(CancellationToken)	Cria de forma assíncrona uma versão preparada (ou compilada) do comando na fonte de dados.
ToString()	Retorna um String que contém o nome do Component, se houver. Esse método não deve ser substituído. (Herdado de Component)

Eventos

Disposed

Ocorre quando o componente é descartado por uma chamada para o método Dispose(). (Herdado de Component)

Implantações explícitas de interface

IDbCommand.Connection	Obtém ou define o IDbConnection usado por essa instância do IDbCommand.
IDbCommand.CreateParameter()	Cria uma nova instância de um objeto IDbDataParameter.
IDbCommand.ExecuteReader()	Executa o CommandText no Connection e cria um IDataReader.
IDbCommand.ExecuteReader(CommandBehavior)	Executa a CommandText no Connectione cria uma IDataReader usando um dos valores CommandBehavior.
IDbCommand.Parameters	Obtém o IDataParameterCollection.
IDbCommand.Transaction	Obtém ou define o DbTransaction no qual esse objeto DbCommand é executado.

Métodos de Extensão

ConfigureAwait(IAsyncDisposable, Boolean)

Configura como as esperas nas tarefas retornadas de um descartável assíncrono serão executadas.

Confira também

• visão geral ADO.NET