DbCommand DbCommand DbCommand DbCommand Class

Definição

Representa uma instrução SQL ou procedimento armazenado a executar contra uma fonte de dados.Represents an SQL statement or stored procedure to execute against a data source. Fornece uma classe base para classes específicas de banco de dados que representam comandos.Provides a base class for database-specific classes that represent commands. ExecuteNonQueryAsync

public ref class DbCommand abstract : System::ComponentModel::Component, IDisposable, System::Data::IDbCommand
public abstract class DbCommand : System.ComponentModel.Component, IDisposable, System.Data.IDbCommand
type DbCommand = class
    inherit Component
    interface IDbCommand
    interface IDisposable
Public MustInherit Class DbCommand
Inherits Component
Implements IDbCommand, IDisposable
Herança
Derivado
Implementações

Construtores

DbCommand() DbCommand() DbCommand() DbCommand()

Cria uma instância do objeto DbCommand.Constructs an instance of the DbCommand object.

Propriedades

CanRaiseEvents CanRaiseEvents CanRaiseEvents CanRaiseEvents

Obtém um valor que indica se o componente pode acionar um evento.Gets a value indicating whether the component can raise an event.

(Inherited from Component)
CommandText CommandText CommandText CommandText

Obtém ou define o comando de texto a ser executado na fonte de dados.Gets or sets the text command to run against the data source.

CommandTimeout CommandTimeout CommandTimeout CommandTimeout

Obtém ou define o tempo de espera antes do término da tentativa de executar um comando e antes de gerar um erro.Gets or sets the wait time before terminating the attempt to execute a command and generating an error.

CommandType CommandType CommandType CommandType

Indica ou especifica como a propriedade CommandText é interpretada.Indicates or specifies how the CommandText property is interpreted.

Connection Connection Connection Connection

Obtém ou define o DbConnection usado pelo DbCommand.Gets or sets the DbConnection used by this DbCommand.

Container Container Container Container

Obtém o IContainer que contém o Component.Gets the IContainer that contains the Component.

(Inherited from Component)
DbConnection DbConnection DbConnection DbConnection

Obtém ou define o DbConnection usado pelo DbCommand.Gets or sets the DbConnection used by this DbCommand.

DbParameterCollection DbParameterCollection DbParameterCollection DbParameterCollection

Obtém a coleção de objetos DbParameter.Gets the collection of DbParameter objects.

DbTransaction DbTransaction DbTransaction DbTransaction

Obtém ou define o DbCommand em que este objeto DbTransaction é executado.Gets or sets the DbTransaction within which this DbCommand object executes.

DesignMode DesignMode DesignMode DesignMode

Obtém um valor que indica se o Component está no modo de design no momento.Gets a value that indicates whether the Component is currently in design mode.

(Inherited from Component)
DesignTimeVisible DesignTimeVisible DesignTimeVisible DesignTimeVisible

Obtém ou define um valor que indica se o objeto de comando deve estar visível em um controle da interface personalizada.Gets or sets a value indicating whether the command object should be visible in a customized interface control.

Events Events Events Events

Obtém a lista de manipuladores de eventos que estão anexados a este Component.Gets the list of event handlers that are attached to this Component.

(Inherited from Component)
Parameters Parameters Parameters Parameters

Obtém a coleção de objetos DbParameter.Gets the collection of DbParameter objects. Para obter mais informações sobre parâmetros, consulte Configurando parâmetros e tipos de dados de parâmetro.For more information on parameters, see Configuring Parameters and Parameter Data Types.

Site Site Site Site

Obtém ou define o ISite do Component.Gets or sets the ISite of the Component.

(Inherited from Component)
Transaction Transaction Transaction Transaction

Obtém ou define o DbCommand em que este objeto DbTransaction é executado.Gets or sets the DbTransaction within which this DbCommand object executes.

UpdatedRowSource UpdatedRowSource UpdatedRowSource UpdatedRowSource

Obtém ou define como os resultados do comando são aplicados a DataRow quando usado pelo método Update de um DbDataAdapter.Gets or sets how command results are applied to the DataRow when used by the Update method of a DbDataAdapter.

Métodos

Cancel() Cancel() Cancel() Cancel()

Tenta cancelar a execução de um DbCommand.Attempts to cancels the execution of a DbCommand.

CreateDbParameter() CreateDbParameter() CreateDbParameter() CreateDbParameter()

Cria uma nova instância de um objeto DbParameter.Creates a new instance of a DbParameter object.

CreateObjRef(Type) CreateObjRef(Type) CreateObjRef(Type) 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.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Inherited from MarshalByRefObject)
CreateParameter() CreateParameter() CreateParameter() CreateParameter()

Cria uma nova instância de um objeto DbParameter.Creates a new instance of a DbParameter object.

Dispose() Dispose() Dispose() Dispose()
Dispose(Boolean) Dispose(Boolean) Dispose(Boolean) Dispose(Boolean)
DisposeAsync() DisposeAsync() DisposeAsync() DisposeAsync()
Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.Determines whether the specified object is equal to the current object.

(Inherited from Object)
ExecuteDbDataReader(CommandBehavior) ExecuteDbDataReader(CommandBehavior) ExecuteDbDataReader(CommandBehavior) ExecuteDbDataReader(CommandBehavior)

Executa o texto do comando na conexão.Executes the command text against the connection.

ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken) ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken) ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken) ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken)

Os provedores devem implementar esse método para fornecer uma implementação não padrão para sobrecargas ExecuteReader.Providers should implement this method to provide a non-default implementation for ExecuteReader overloads.

A implementação padrão invoca o método ExecuteReader() síncrono e retorna uma tarefa concluída, bloqueando o thread de chamada.The default implementation invokes the synchronous ExecuteReader() method and returns a completed task, blocking the calling thread. A implementação padrão retornará uma tarefa cancelada se já tiver passado um token de cancelamento.The default implementation will return a cancelled task if passed an already cancelled cancellation token. Exceções geradas por ExecuteReader serão comunicadas por meio da propriedade Exceção de Tarefa retornada.Exceptions thrown by ExecuteReader will be communicated via the returned Task Exception property.

Esse método aceita um token de cancelamento que pode ser usado para solicitar a operação a ser cancelada no início.This method accepts a cancellation token that can be used to request the operation to be cancelled early. As implementações podem ignorar essa solicitação.Implementations may ignore this request.

ExecuteNonQuery() ExecuteNonQuery() ExecuteNonQuery() ExecuteNonQuery()

Executa uma instrução SQL em relação a um objeto de conexão.Executes a SQL statement against a connection object.

ExecuteNonQueryAsync() ExecuteNonQueryAsync() ExecuteNonQueryAsync() ExecuteNonQueryAsync()

Uma versão assíncrona de ExecuteNonQuery(), que executa uma instrução SQL em um objeto de conexão.An asynchronous version of ExecuteNonQuery(), which executes a SQL statement against a connection object.

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

ExecuteNonQueryAsync(CancellationToken) ExecuteNonQueryAsync(CancellationToken) ExecuteNonQueryAsync(CancellationToken) ExecuteNonQueryAsync(CancellationToken)

Essa é a versão assíncrona de ExecuteNonQuery().This is the asynchronous version of ExecuteNonQuery(). Provedores devem substituir com uma implementação apropriada.Providers should override with an appropriate implementation. Opcionalmente, o token de cancelamento pode ser ignorado.The cancellation token may optionally be ignored.

A implementação padrão invoca o método ExecuteNonQuery() síncrono e retorna uma tarefa concluída, bloqueando o thread de chamada.The default implementation invokes the synchronous ExecuteNonQuery() method and returns a completed task, blocking the calling thread. A implementação padrão retornará uma tarefa cancelada se já tiver passado um token de cancelamento.The default implementation will return a cancelled task if passed an already cancelled cancellation token. Exceções geradas por ExecuteNonQuery() serão comunicadas por meio da propriedade Exceção de Tarefa retornada.Exceptions thrown by ExecuteNonQuery() will be communicated via the returned Task Exception property.

Não invoque outros métodos e propriedades do objeto DbCommand até a Tarefa retornada ser concluída.Do not invoke other methods and properties of the DbCommand object until the returned Task is complete.

ExecuteReader() ExecuteReader() ExecuteReader() ExecuteReader()

Executa o CommandText no Connection e retorna um DbDataReader.Executes the CommandText against the Connection, and returns an DbDataReader.

ExecuteReader(CommandBehavior) ExecuteReader(CommandBehavior) ExecuteReader(CommandBehavior) ExecuteReader(CommandBehavior)

Executa o CommandText para o Connection e retorna um DbDataReader usando um dos valores de CommandBehavior.Executes the CommandText against the Connection, and returns an DbDataReader using one of the CommandBehavior values.

ExecuteReaderAsync() ExecuteReaderAsync() ExecuteReaderAsync() ExecuteReaderAsync()

Uma versão assíncrona de ExecuteReader, que executa o CommandText contra o Connection e retorna um DbDataReader.An asynchronous version of ExecuteReader, which executes the CommandText against the Connection and returns a DbDataReader.

Invoca ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken) com CancellationToken.None.Invokes ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken) with CancellationToken.None.

ExecuteReaderAsync(CancellationToken) ExecuteReaderAsync(CancellationToken) ExecuteReaderAsync(CancellationToken) ExecuteReaderAsync(CancellationToken)

Uma versão assíncrona de ExecuteReader, que executa o CommandText contra o Connection e retorna um DbDataReader.An asynchronous version of ExecuteReader, which executes the CommandText against the Connection and returns a DbDataReader. Esse método propaga a notificação de que as operações devem ser canceladas.This method propagates a notification that operations should be canceled.

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

ExecuteReaderAsync(CommandBehavior) ExecuteReaderAsync(CommandBehavior) ExecuteReaderAsync(CommandBehavior) ExecuteReaderAsync(CommandBehavior)

Uma versão assíncrona de ExecuteReader, que executa o CommandText contra o Connection e retorna um DbDataReader.An asynchronous version of ExecuteReader, which executes the CommandText against the Connection and returns a DbDataReader.

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

ExecuteReaderAsync(CommandBehavior, CancellationToken) ExecuteReaderAsync(CommandBehavior, CancellationToken) ExecuteReaderAsync(CommandBehavior, CancellationToken) ExecuteReaderAsync(CommandBehavior, CancellationToken)

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

ExecuteScalar() ExecuteScalar() ExecuteScalar() ExecuteScalar()

Executa a consulta e retorna a primeira coluna da primeira linha do conjunto de resultados retornado pela consulta.Executes the query and returns the first column of the first row in the result set returned by the query. Todas as outras colunas e linhas são ignoradas.All other columns and rows are ignored.

ExecuteScalarAsync() ExecuteScalarAsync() ExecuteScalarAsync() ExecuteScalarAsync()

Uma versão assíncrona de ExecuteScalar(), que executa a consulta e retorna a primeira coluna da primeira linha no conjunto de resultados retornado pela consulta.An asynchronous version of ExecuteScalar(), which executes the query and returns the first column of the first row in the result set returned by the query. Todas as outras colunas e linhas são ignoradas.All other columns and rows are ignored.

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

ExecuteScalarAsync(CancellationToken) ExecuteScalarAsync(CancellationToken) ExecuteScalarAsync(CancellationToken) ExecuteScalarAsync(CancellationToken)

Essa é a versão assíncrona de ExecuteScalar().This is the asynchronous version of ExecuteScalar(). Provedores devem substituir com uma implementação apropriada.Providers should override with an appropriate implementation. Opcionalmente, o token de cancelamento pode ser ignorado.The cancellation token may optionally be ignored.

A implementação padrão invoca o método ExecuteScalar() síncrono e retorna uma tarefa concluída, bloqueando o thread de chamada.The default implementation invokes the synchronous ExecuteScalar() method and returns a completed task, blocking the calling thread. A implementação padrão retornará uma tarefa cancelada se já tiver passado um token de cancelamento.The default implementation will return a cancelled task if passed an already cancelled cancellation token. Exceções geradas por ExecuteScalar serão comunicadas por meio da propriedade Exceção de Tarefa retornada.Exceptions thrown by ExecuteScalar will be communicated via the returned Task Exception property.

Não invoque outros métodos e propriedades do objeto DbCommand até a Tarefa retornada ser concluída.Do not invoke other methods and properties of the DbCommand object until the returned Task is complete.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Serve como a função de hash padrão.Serves as the default hash function.

(Inherited from Object)
GetLifetimeService() GetLifetimeService() GetLifetimeService() GetLifetimeService()

Recupera o objeto de serviço de tempo de vida atual que controla a política de ciclo de vida para esta instância.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Inherited from MarshalByRefObject)
GetService(Type) GetService(Type) GetService(Type) GetService(Type)

Retorna um objeto que representa um serviço fornecido pelo Component ou pelo seu Container.Returns an object that represents a service provided by the Component or by its Container.

(Inherited from Component)
GetType() GetType() GetType() GetType()

Obtém o Type da instância atual.Gets the Type of the current instance.

(Inherited from Object)
InitializeLifetimeService() InitializeLifetimeService() InitializeLifetimeService() InitializeLifetimeService()

Obtém um objeto de serviço de tempo de vida para controlar a política de tempo de vida para essa instância.Obtains a lifetime service object to control the lifetime policy for this instance.

(Inherited from MarshalByRefObject)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Cria uma cópia superficial do Object atual.Creates a shallow copy of the current Object.

(Inherited from Object)
MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean)

Cria uma cópia superficial do objeto MarshalByRefObject atual.Creates a shallow copy of the current MarshalByRefObject object.

(Inherited from MarshalByRefObject)
Prepare() Prepare() Prepare() Prepare()

Cria uma versão preparada (ou compilada) do comando na fonte de dados.Creates a prepared (or compiled) version of the command on the data source.

PrepareAsync(CancellationToken) PrepareAsync(CancellationToken) PrepareAsync(CancellationToken) PrepareAsync(CancellationToken)
ToString() ToString() ToString() ToString()

Retorna um String que contém o nome do Component, se houver.Returns a String containing the name of the Component, if any. Esse método não deve ser substituído.This method should not be overridden.

(Inherited from Component)

Implantações explícitas de interface

IDbCommand.Connection IDbCommand.Connection IDbCommand.Connection IDbCommand.Connection

Obtém ou define o IDbConnection usado por essa instância do IDbCommand.Gets or sets the IDbConnection used by this instance of the IDbCommand.

IDbCommand.CreateParameter() IDbCommand.CreateParameter() IDbCommand.CreateParameter() IDbCommand.CreateParameter()

Cria uma nova instância de um objeto IDbDataParameter.Creates a new instance of an IDbDataParameter object.

IDbCommand.ExecuteReader() IDbCommand.ExecuteReader() IDbCommand.ExecuteReader() IDbCommand.ExecuteReader()

Executa o CommandText no Connection e compila um IDataReader.Executes the CommandText against the Connection and builds an IDataReader.

IDbCommand.ExecuteReader(CommandBehavior) IDbCommand.ExecuteReader(CommandBehavior) IDbCommand.ExecuteReader(CommandBehavior) IDbCommand.ExecuteReader(CommandBehavior)

Executa o CommandText para o Connection e cria um IDataReader usando um dos valores de CommandBehavior.Executes the CommandText against the Connection, and builds an IDataReader using one of the CommandBehavior values.

IDbCommand.Parameters IDbCommand.Parameters IDbCommand.Parameters IDbCommand.Parameters

Obtém o IDataParameterCollection.Gets the IDataParameterCollection.

IDbCommand.Transaction IDbCommand.Transaction IDbCommand.Transaction IDbCommand.Transaction

Obtém ou define o DbCommand em que este objeto DbTransaction é executado.Gets or sets the DbTransaction within which this DbCommand object executes.

Eventos

Disposed Disposed Disposed Disposed

Ocorre quando o componente é disposto por uma chamada para o método Dispose().Occurs when the component is disposed by a call to the Dispose() method.

(Inherited from Component)

Aplica-se a

Veja também