DbCommand Classe
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Representa uma instrução SQL ou procedimento armazenado a executar contra uma fonte de dados. Fornece uma classe base para classes específicas de banco de dados que representam comandos. ExecuteNonQueryAsync.
public ref class DbCommand abstract : IDisposable
public ref class DbCommand abstract : System::ComponentModel::Component, IAsyncDisposable, IDisposable, System::Data::IDbCommand
public ref class DbCommand abstract : IDisposable, System::Data::IDbCommand
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, IAsyncDisposable, IDisposable, System.Data.IDbCommand
public abstract class DbCommand : IDisposable, System.Data.IDbCommand
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
interface IAsyncDisposable
type DbCommand = class
interface IDbCommand
interface IDisposable
type DbCommand = class
inherit Component
interface IDbCommand
interface IDisposable
Public MustInherit Class DbCommand
Implements IDisposable
Public MustInherit Class DbCommand
Inherits Component
Implements IAsyncDisposable, IDbCommand, IDisposable
Public MustInherit Class DbCommand
Implements IDbCommand, 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
-
DbCommand
- Herança
- Derivado
- Implementações
Construtores
DbCommand() |
Cria uma instância do objeto DbCommand. |
Propriedades
CanRaiseEvents |
Obtém um valor que indica se o componente pode acionar 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 pelo DbCommand. |
Container |
Obtém o IContainer que contém o Component. (Herdado de Component) |
DbConnection |
Obtém ou define o DbConnection usado pelo DbCommand. |
DbParameterCollection |
Obtém a coleção de objetos DbParameter. |
DbTransaction |
Obtém ou define o DbCommand em que este objeto DbTransaction é 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 da interface personalizada. |
Events |
Obtém a lista de manipuladores de eventos que estão 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 DbCommand em que este objeto DbTransaction é executado. |
UpdatedRowSource |
Obtém ou define como os resultados do comando são aplicados a DataRow quando usado 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() |
Realiza tarefas definidas pelo aplicativo associadas à 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 sobrecargas ExecuteReader. A implementação padrão invoca o método ExecuteReader() síncrono e retorna uma tarefa concluída, bloqueando o thread de chamada. A implementação padrão retornará uma tarefa cancelada se já tiver passado um token de cancelamento. Exceções geradas por ExecuteReader serão comunicadas por meio da propriedade Exceção de Tarefa retornada. Esse método aceita um token de cancelamento que pode ser usado para solicitar a operação a ser cancelada no início. 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 seu objeto de conexão, retornando o número de linhas afetadas. Invoca ExecuteNonQueryAsync(CancellationToken) com CancellationToken.None. |
ExecuteNonQueryAsync(CancellationToken) |
Essa é a versão assíncrona de ExecuteNonQuery(). 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 ExecuteNonQuery() síncrono e retorna uma tarefa concluída, bloqueando o thread de chamada. A implementação padrão retornará uma tarefa cancelada se já tiver passado um token de cancelamento. Exceções geradas por ExecuteNonQuery() serão comunicadas por meio da propriedade Exceção de Tarefa retornada. Não invoque outros métodos e propriedades do objeto |
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 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 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 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) |
Essa é a versão assíncrona de ExecuteScalar(). 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 ExecuteScalar() síncrono e retorna uma tarefa concluída, bloqueando o thread de chamada. A implementação padrão retornará uma tarefa cancelada se já tiver passado um token de cancelamento. Exceções geradas por ExecuteScalar serão comunicadas por meio da propriedade Exceção de Tarefa retornada. Não invoque outros métodos e propriedades do objeto |
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 ciclo de vida para esta instância. (Herdado de MarshalByRefObject) |
GetService(Type) |
Retorna 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() |
Obsoleto.
Obtém um objeto de serviço de tempo de vida para controlar a política de tempo de vida para essa instância. (Herdado de MarshalByRefObject) |
MemberwiseClone() |
Cria uma cópia superficial do Object atual. (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 maneira 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
Disposed |
Ocorre quando o componente é disposto por uma chamada ao 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 compila um IDataReader. |
IDbCommand.ExecuteReader(CommandBehavior) |
Executa o CommandText para o Connection e cria um IDataReader usando um dos valores de CommandBehavior. |
IDbCommand.Parameters |
Obtém o IDataParameterCollection. |
IDbCommand.Transaction |
Obtém ou define o DbCommand em que este objeto DbTransaction é executado. |
Métodos de Extensão
ConfigureAwait(IAsyncDisposable, Boolean) |
Configura como as esperas nas tarefas retornadas de um descartável assíncrono são realizadas. |
Aplica-se a
Confira também
Comentários
https://aka.ms/ContentUserFeedback.
Brevemente: Ao longo de 2024, vamos descontinuar progressivamente o GitHub Issues como mecanismo de feedback para conteúdos e substituí-lo por um novo sistema de feedback. Para obter mais informações, veja:Submeter e ver comentários