DbCommand Classe

Definição

Espaço de Nomes:
System.Data.Common
Assemblagem:
System.Data.Common.dll
Assemblagem:
System.Data.dll
Assemblagem:
netstandard.dll

Representa uma instrução SQL ou procedimento armazenado para executar contra uma fonte de dados. Fornece uma classe base para classes específicas da base 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

Name Description
DbCommand()

Constrói uma instância do DbCommand objeto.

Propriedades

Name Description
CanRaiseEvents

Obtém um valor que indica se o componente pode gerar um evento.

(Herdado de Component)
CommandText

Recebe ou define o comando de texto para ser executado contra a fonte de dados.
CommandTimeout

Obtém ou define o tempo de espera (em segundos) antes de terminar 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 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

Fica com a coleção de DbParameter objetos.
DbTransaction

Obtém ou define o DbTransaction dentro do qual este DbCommand objeto executa.
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 de interface personalizado.
Events

Obtém a lista de gestores de eventos que estão ligados a isto Component.

(Herdado de Component)
Parameters

Fica com a coleção de DbParameter objetos. Para mais informações sobre parâmetros, consulte Configuração de Parâmetros e Tipos de Dados de Parâmetros.
Site

Obtém ou define o ISite do Component.

(Herdado de Component)
Transaction

Obtém ou define o DbTransaction dentro do qual este DbCommand objeto executa.
UpdatedRowSource

Obtém ou define como os resultados dos comandos são aplicados ao DataRow quando usados pelo método Update de um DbDataAdapter.

Métodos

Name Description
Cancel()

Tentativas de 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 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 DbParameter objeto.
Dispose()

Realiza tarefas definidas pela aplicação associadas à libertação, libertação ou reinício de recursos não geridos.
Dispose()

Liberta todos os recursos utilizados pelo Component.

(Herdado de Component)
Dispose(Boolean)

Liberta os recursos não geridos usados pelo DbCommand e opcionalmente liberta os recursos geridos.
Dispose(Boolean)

Liberta os recursos não geridos usados pelo Component e opcionalmente liberta os recursos geridos.

(Herdado de Component)
DisposeAsync()

Elimina assíncronamente o objeto de comando.
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.
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.
ExecuteNonQuery()

Executa o comando contra o seu objeto de ligação, devolvendo o número de linhas afetadas.
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.
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 DbCommand objeto até que a tarefa devolvida esteja concluída.
ExecuteReader()

Executa o comando contra a sua ligação, devolvendo um DbDataReader que pode ser usado para aceder aos resultados.
ExecuteReader(CommandBehavior)

Executa o comando contra a sua ligação, devolvendo um DbDataReader que pode ser usado para aceder aos resultados.
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.
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).
ExecuteReaderAsync(CommandBehavior, CancellationToken)

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

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.
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.
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 DbCommand objeto até que a tarefa devolvida esteja concluída.
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()

Cria uma versão preparada (ou compilada) do comando na fonte de dados.
PrepareAsync(CancellationToken)

De forma assíncrona, cria uma versão preparada (ou compilada) do comando na fonte de dados.
ToString()

Devolve uma cadeia que representa o objeto atual.

(Herdado de Object)
ToString()

Devolve a String contendo o nome do Component, se existir. Este método não deve ser ultrapassado.

(Herdado de Component)

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.
IDbCommand.CreateParameter()

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

Executa o CommandText contra o Connection e constrói um IDataReader.
IDbCommand.ExecuteReader(CommandBehavior)

Executa o CommandText contra o Connection, e constrói um IDataReader usando um dos CommandBehavior valores.
IDbCommand.Parameters

Obtém o IDataParameterCollection.
IDbCommand.Transaction

Obtém ou define o DbTransaction dentro do qual este DbCommand objeto executa.

Métodos da Extensão

Name Description
ConfigureAwait(IAsyncDisposable, Boolean)

Configura como aguarda nas tarefas devolvidas de um descartável assíncrono será realizada.

Aplica-se a

Ver também