DbCommand Classe

Definição

Namespace:
System.Data.Common
Assembly:
System.Data.Common.dll
Assembly:
System.Data.dll
Assembly:
netstandard.dll

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 : IDisposable
public ref class DbCommand abstract : System::ComponentModel::Component, IDisposable, System::Data::IDbCommand
public ref class DbCommand abstract : System::ComponentModel::Component, System::Data::IDbCommand
public ref class DbCommand abstract : System::ComponentModel::Component, IAsyncDisposable, System::Data::IDbCommand
public abstract class DbCommand : IDisposable
public abstract class DbCommand : System.ComponentModel.Component, IDisposable, System.Data.IDbCommand
public abstract class DbCommand : System.ComponentModel.Component, System.Data.IDbCommand
public abstract class DbCommand : System.ComponentModel.Component, IAsyncDisposable, System.Data.IDbCommand
type DbCommand = class
    interface IDisposable
type DbCommand = class
    inherit Component
    interface IDbCommand
    interface IDisposable
type DbCommand = class
    inherit Component
    interface IDbCommand
    interface IDisposable
    interface IAsyncDisposable
Public MustInherit Class DbCommand
Implements IDisposable
Public MustInherit Class DbCommand
Inherits Component
Implements IDbCommand, IDisposable
Public MustInherit Class DbCommand
Inherits Component
Implements IDbCommand
Public MustInherit Class DbCommand
Inherits Component
Implements IAsyncDisposable, IDbCommand
Herança
Object
DbCommand
Herança
Object
MarshalByRefObject
Component
DbCommand
Derivado
Implementações
IDisposable IDbCommand IAsyncDisposable

Construtores

Nome Description
DbCommand()

Constrói uma instância do DbCommand objeto.

Propriedades

Nome Description
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 CommandText propriedade é interpretada.
Connection

Obtém ou define o DbConnection usado por isso DbCommand.
Container

Obtém o IContainer que contém o Component.

(Herdado de Component)
DbConnection

Obtém ou define o DbConnection usado por isso DbCommand.
DbParameterCollection

Obtém a coleção de DbParameter objetos.
DbTransaction

Obtém ou define o DbTransaction interior no qual este DbCommand objeto é executado.
DesignMode

Obtém um valor que indica se o Component está no modo de design no momento.

(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 isso Component.

(Herdado de Component)
Parameters

Obtém a coleção de DbParameter objetos. 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 interior no qual este DbCommand objeto é executado.
UpdatedRowSource

Obtém ou define como os resultados do comando são aplicados ao DataRow quando usado pelo método Update de um DbDataAdapter.

Métodos

Nome Description
Cancel()

Tenta cancelar a execução de um DbCommand.
CreateDbParameter()

Cria uma nova instância de um DbParameter objeto.
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 DbParameter objeto.
Dispose()

Executa tarefas definidas pelo aplicativo associadas à liberação, liberação ou redefinição de recursos não gerenciados.
Dispose()

Libera todos os recursos usados pelo Component.

(Herdado de Component)
Dispose(Boolean)

Libera os recursos não gerenciados usados pelo DbCommand e, opcionalmente, libera os recursos gerenciados.
Dispose(Boolean)

Libera os recursos não gerenciados usados pelo Component e, opcionalmente, libera os recursos gerenciados.

(Herdado de Component)
DisposeAsync()

Descarta 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 ExecuteReader sobrecargas.

A implementação padrão invoca o método síncrono ExecuteReader() 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 de ExecuteNonQuery(), que executa o comando em seu objeto de conexão, retornando o número de linhas afetadas.

ExecuteNonQueryAsync(CancellationToken) Invoca com CancellationToken.None.
ExecuteNonQueryAsync(CancellationToken)

Esta é a versão assíncrona de 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 síncrono ExecuteNonQuery() 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 serão comunicadas por ExecuteNonQuery() meio da propriedade de Exceção de Tarefa retornada.

Não invoque outros métodos e propriedades do DbCommand objeto 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 de ExecuteReader, que executa o comando em relação à sua conexão, retornando uma DbDataReader que pode ser usada para acessar os resultados.

ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken) Invoca com CancellationToken.None.
ExecuteReaderAsync(CancellationToken)

Uma versão assíncrona de ExecuteReader, que executa o comando em relação à sua conexão, retornando uma DbDataReader que pode ser usada para acessar os resultados.

ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken)Invoca .
ExecuteReaderAsync(CommandBehavior, CancellationToken)

ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken)Invoca .
ExecuteReaderAsync(CommandBehavior)

Uma versão assíncrona de ExecuteReader, que executa o comando em relação à sua conexão, retornando uma DbDataReader que pode ser usada para acessar os resultados.

ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken)Invoca .
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 de 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.

ExecuteScalarAsync(CancellationToken) Invoca com CancellationToken.None.
ExecuteScalarAsync(CancellationToken)

Esta é a versão assíncrona de 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 síncrono ExecuteScalar() 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 DbCommand objeto até que a Tarefa retornada seja concluída.
GetHashCode()

Serve como a função hash predefinida.

(Herdado de Object)
GetLifetimeService()

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 sua Container.

(Herdado de Component)
GetType()

Obtém o Type da instância atual.

(Herdado de Object)
InitializeLifetimeService()

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 atual MarshalByRefObject .

(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 uma cadeia de caracteres que representa o objeto atual.

(Herdado de Object)
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

Nome Description
Disposed

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

(Herdado de Component)

Implantações explícitas de interface

Nome Description
IDbCommand.Connection

Obtém ou define o IDbConnection usado por esta instância do IDbCommand.
IDbCommand.CreateParameter()

Cria uma nova instância de um IDbDataParameter objeto.
IDbCommand.ExecuteReader()

Executa o CommandText contra e Connection cria um IDataReader.
IDbCommand.ExecuteReader(CommandBehavior)

Executa o CommandText contra e Connectioncria um usando um IDataReader dos CommandBehavior valores.
IDbCommand.Parameters

Obtém IDataParameterCollection.
IDbCommand.Transaction

Obtém ou define o DbTransaction interior no qual este DbCommand objeto é executado.

Métodos de Extensão

Nome Description
ConfigureAwait(IAsyncDisposable, Boolean)

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

Aplica-se a

Confira também