OleDbCommand Classe

Definição

Namespace:

System.Data.OleDb

Assembly:

System.Data.OleDb.dll

Pacote:

System.Data.OleDb v8.0.0

Origem:

OleDbCommand.cs

Representa uma instrução SQL ou procedimento armazenado a executar contra uma fonte de dados.

public ref class OleDbCommand sealed : System::Data::Common::DbCommand, ICloneable, IDisposable

public sealed class OleDbCommand : System.Data.Common.DbCommand, ICloneable, IDisposable

type OleDbCommand = class
    inherit DbCommand
    interface ICloneable
    interface IDbCommand
    interface IDisposable

Public NotInheritable Class OleDbCommand
Inherits DbCommand
Implements ICloneable, IDisposable

Herança

Object

DbCommand

OleDbCommand

Implementações

IDbCommand ICloneable IDisposable

Exemplos

O exemplo a seguir usa , OleDbCommandjunto OleDbDataAdapter e OleDbConnection, para selecionar linhas de um banco de dados do Access. O preenchido DataSet é retornado. O exemplo é passado um inicializado DataSet, 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 é criada, as propriedades de OleDbCommand leitura/gravação são definidas com seus valores iniciais. Para obter uma lista desses valores, consulte o OleDbCommand construtor .

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 CommandText propriedade e reutilizar o OleDbCommand objeto. No entanto, você deve fechar o OleDbDataReader antes de executar um comando novo ou anterior.

Se um fatal OleDbException (por exemplo, um nível de severidade SQL Server de 20 ou mais) 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 uma OleDbConnection.
OleDbCommand(String, OleDbConnection, OleDbTransaction)	Inicializa uma nova instância da classe OleDbCommand com o texto da consulta, uma OleDbConnection e a Transaction.

Propriedades

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 antes de 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.
DbConnection	Obtém ou define o DbConnection usado pelo DbCommand. (Herdado de DbCommand)
DbParameterCollection	Obtém a coleção de objetos DbParameter. (Herdado de DbCommand)
DbTransaction	Obtém ou define o DbCommand em que este objeto DbTransaction é executado. (Herdado de DbCommand)
DesignTimeVisible	Obtém ou define um valor que indica se o objeto de comando deve estar visível em um controle do Designer de Formulários do Windows personalizado.
Parameters	Obtém o OleDbParameterCollection.
Transaction	Obtém ou define o OleDbCommand em que o OleDbTransaction é executado.
UpdatedRowSource	Obtém ou define como os resultados do comando são aplicados a DataRow quando usado pelo método Update de 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)
CreateParameter()	Cria uma nova instância de um objeto OleDbParameter.
Dispose()	Realiza tarefas definidas pelo aplicativo associadas à liberação ou à redefinição de recursos não gerenciados. (Herdado de DbCommand)
Dispose(Boolean)	Libera os recursos não gerenciados usados pelo DbCommand e opcionalmente libera os recursos gerenciados. (Herdado de DbCommand)
DisposeAsync()	Descarta 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 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 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. (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 de ExecuteNonQuery(), que executa o comando em seu objeto de conexão, retornando o número de linhas afetadas. Invoca ExecuteNonQueryAsync(CancellationToken) com CancellationToken.None. (Herdado de DbCommand)
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 DbCommand até a Tarefa retornada ser concluída. (Herdado de DbCommand)
ExecuteReader()	Envia o CommandText para o Connection e cria um OleDbDataReader.
ExecuteReader(CommandBehavior)	Envia o CommandText para o Connection e cria um OleDbDataReader usando um dos valores CommandBehavior.
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. (Herdado de DbCommand)
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). (Herdado de DbCommand)
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). (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 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. Invoca ExecuteScalarAsync(CancellationToken) com CancellationToken.None. (Herdado de DbCommand)
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 DbCommand até a Tarefa retornada ser concluída. (Herdado de DbCommand)
GetHashCode()	Serve como a função de hash padrão. (Herdado de Object)
GetType()	Obtém o Type da instância atual. (Herdado de Object)
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
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. (Herdado de DbCommand)
ResetCommandTimeout()	Redefine a propriedade CommandTimeout para o valor padrão.
ToString()	Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object)

Implantações explícitas de interface

ICloneable.Clone()	Para obter uma descrição desse membro, confira Clone().
IDbCommand.ExecuteReader()	Para obter uma descrição desse membro, confira ExecuteReader().
IDbCommand.ExecuteReader(CommandBehavior)	Executa o CommandText para o Connection e cria um IDataReader usando um dos valores de CommandBehavior.

Confira também

• OleDbDataAdapter
• OleDbConnection
• Trabalhando com comandos