OleDbCommand Classe

Definição

Representa uma instrução SQL ou um procedimento armazenado a ser executado em uma fonte de dados.

public ref class OleDbCommand sealed : System::Data::Common::DbCommand, ICloneable, IDisposable
public ref class OleDbCommand sealed : System::ComponentModel::Component, ICloneable, IDisposable, System::Data::IDbCommand
public ref class OleDbCommand sealed : System::Data::Common::DbCommand, ICloneable
public sealed class OleDbCommand : System.Data.Common.DbCommand, ICloneable, IDisposable
public sealed class OleDbCommand : System.ComponentModel.Component, ICloneable, IDisposable, System.Data.IDbCommand
public sealed class OleDbCommand : System.Data.Common.DbCommand, ICloneable
type OleDbCommand = class
    inherit DbCommand
    interface IDbCommand
    interface IDisposable
    interface ICloneable
type OleDbCommand = class
    inherit Component
    interface ICloneable
    interface IDbCommand
    interface IDisposable
type OleDbCommand = class
    inherit DbCommand
    interface ICloneable
    interface IDbCommand
    interface IDisposable
Public NotInheritable Class OleDbCommand
Inherits DbCommand
Implements ICloneable, IDisposable
Public NotInheritable Class OleDbCommand
Inherits Component
Implements ICloneable, IDbCommand, IDisposable
Public NotInheritable Class OleDbCommand
Inherits DbCommand
Implements ICloneable
Herança
Herança
Implementações

Exemplos

O exemplo a seguir usa o OleDbCommand, juntamente com OleDbDataAdapter e OleDbConnection, para selecionar linhas de um banco de dados do Access. A DataSet preenchida é retornada. O exemplo é passado por um DataSetinicializado, uma cadeia de conexão, uma cadeia de caracteres de consulta que é uma instrução SQL SELECT e uma cadeia de caracteres que é o nome da tabela de banco de dados de origem.

public void ReadMyData(string connectionString)
{
    string queryString = "SELECT OrderID, CustomerID FROM Orders";
    using (OleDbConnection connection = new OleDbConnection(connectionString))
    {
        OleDbCommand command = new OleDbCommand(queryString, connection);
        connection.Open();
        OleDbDataReader reader = command.ExecuteReader();

        while (reader.Read())
        {
            Console.WriteLine(reader.GetInt32(0) + ", " + reader.GetString(1));
        }
        // always call Close when done reading.
        reader.Close();
    }
}
Public Sub ReadMyData(ByVal connectionString As String)
    Dim queryString As String = "SELECT OrderID, CustomerID FROM Orders"
    Using connection As New OleDbConnection(connectionString)
        Dim command As New OleDbCommand(queryString, connection)

        connection.Open()

        Dim reader As OleDbDataReader = command.ExecuteReader()
        While reader.Read()
            Console.WriteLine(reader.GetInt32(0).ToString() + ", " _
               + reader.GetString(1))
        End While

        ' always call Close when done reading.
        reader.Close()
    End Using
End Sub

Comentários

Quando uma instância de OleDbCommand é criada, as propriedades de leitura/gravação são definidas como seus valores iniciais. Para obter uma lista desses valores, consulte o construtor OleDbCommand.

OleDbCommand apresenta os seguintes métodos executando comandos em uma fonte de dados:

Item Descrição
ExecuteReader Executa comandos que retornam linhas. ExecuteReader pode não ter o efeito desejado se usado para executar comandos como instruções SQL SET.
ExecuteNonQuery Executa comandos como instruções SQL INSERT, DELETE, UPDATE e SET.
ExecuteScalar Recupera um único valor, por exemplo, um valor agregado de um banco de dados.

Você pode redefinir a propriedade CommandText e reutilizar o objeto OleDbCommand. No entanto, você deve fechar o OleDbDataReader antes de executar um comando novo ou anterior.

Se um OleDbException fatal (por exemplo, um nível de gravidade do SQL Server igual a 20 ou superior) for gerado pelo método que executa um OleDbCommand, o OleDbConnection, a conexão poderá ser fechada. No entanto, o usuário pode reabrir a conexão e continuar.

Construtores

OleDbCommand()

Inicializa uma nova instância da classe OleDbCommand.

OleDbCommand(String)

Inicializa uma nova instância da classe OleDbCommand com o texto da consulta.

OleDbCommand(String, OleDbConnection)

Inicializa uma nova instância da classe OleDbCommand com o texto da consulta e um OleDbConnection.

OleDbCommand(String, OleDbConnection, OleDbTransaction)

Inicializa uma nova instância da classe OleDbCommand com o texto da consulta, um OleDbConnectione o Transaction.

Propriedades

CanRaiseEvents

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

(Herdado de Component)
CommandText

Obtém ou define a instrução SQL ou o procedimento armazenado a ser executado na fonte de dados.

CommandTimeout

Obtém ou define o tempo de espera (em segundos) antes de encerrar uma tentativa de executar um comando e gerar um erro.

CommandType

Obtém ou define um valor que indica como a propriedade CommandText é interpretada.

Connection

Obtém ou define o OleDbConnection usado por essa instância do OleDbCommand.

Container

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

(Herdado de Component)
DbConnection

Obtém ou define o DbConnection usado por este DbCommand.

(Herdado de DbCommand)
DbParameterCollection

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

(Herdado de DbCommand)
DbTransaction

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

(Herdado de DbCommand)
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 personalizado do Designer de Formulários do Windows.

Events

Obtém a lista de manipuladores de eventos anexados a este Component.

(Herdado de Component)
Parameters

Obtém o OleDbParameterCollection.

Site

Obtém ou define o ISite do Component.

(Herdado de Component)
Transaction

Obtém ou define o OleDbTransaction no qual o OleDbCommand é executado.

UpdatedRowSource

Obtém ou define como os resultados do comando são aplicados ao DataRow quando usados pelo método Update do OleDbDataAdapter.

Métodos

Cancel()

Tenta cancelar a execução de um OleDbCommand.

Clone()

Cria um novo objeto OleDbCommand que é uma cópia da instância atual.

CreateDbParameter()

Cria uma nova instância de um objeto DbParameter.

(Herdado de DbCommand)
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 OleDbParameter.

Dispose()

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

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

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

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

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

(Herdado de DbCommand)
ExecuteNonQuery()

Executa uma instrução SQL no Connection e retorna 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.

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

(Herdado de DbCommand)
ExecuteReader()

Envia o CommandText para o Connection e cria um OleDbDataReader.

ExecuteReader(CommandBehavior)

Envia o CommandText para o Connectione cria uma OleDbDataReader usando um dos valores CommandBehavior.

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.

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

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

(Herdado de DbCommand)
ExecuteReaderAsync(CommandBehavior, CancellationToken)

Invoca ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken).

(Herdado de DbCommand)
ExecuteScalar()

Executa a consulta e retorna a primeira coluna da primeira linha no conjunto de resultados retornado pela consulta. Colunas ou linhas adicionais são ignoradas.

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.

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

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

(Herdado de DbCommand)
ResetCommandTimeout()

Redefine a propriedade CommandTimeout para o valor padrão.

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

ICloneable.Clone()

Para obter uma descrição desse membro, consulte Clone().

IDbCommand.Connection

Obtém ou define o IDbConnection usado por essa instância do IDbCommand.

(Herdado de DbCommand)
IDbCommand.CreateParameter()

Esta API dá suporte à infraestrutura do produto e não deve ser usada diretamente do seu código.

Cria uma nova instância de um objeto IDbDataParameter.

IDbCommand.CreateParameter()

Cria uma nova instância de um objeto IDbDataParameter.

(Herdado de DbCommand)
IDbCommand.ExecuteReader()

Para obter uma descrição desse membro, consulte ExecuteReader().

IDbCommand.ExecuteReader(CommandBehavior)

Executa a CommandText no Connectione cria uma IDataReader usando um dos valores CommandBehavior.

IDbCommand.Parameters

Obtém o IDataParameterCollection.

(Herdado de DbCommand)
IDbCommand.Transaction

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

(Herdado de DbCommand)

Métodos de Extensão

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