OleDbCommand Classe

Definição

Namespace:

System.Data.OleDb

Assembly:

System.Data.OleDb.dll

Pacote:

System.Data.OleDb v11.0.0-preview.2.26159.112

Origem:

OleDbCommand.cs

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

[System.Diagnostics.CodeAnalysis.RequiresDynamicCode("OleDbConnection is not AOT-compatible.")]
public sealed class OleDbCommand : System.Data.Common.DbCommand, ICloneable, IDisposable

[<System.Diagnostics.CodeAnalysis.RequiresDynamicCode("OleDbConnection is not AOT-compatible.")>]
type OleDbCommand = class
    inherit DbCommand
    interface IDbCommand
    interface IDisposable
    interface ICloneable

Public NotInheritable Class OleDbCommand
Inherits DbCommand
Implements ICloneable, IDisposable

Herança

Object

DbCommand

OleDbCommand

Atributos

RequiresDynamicCodeAttribute

Implementações

IDbCommand ICloneable IDisposable

Exemplos

O exemplo a seguir usa o OleDbCommand, junto OleDbDataAdapter e OleDbConnection, para selecionar linhas de um banco de dados do Access. Em seguida, o preenchimento DataSet é retornado. O exemplo é passado por uma cadeia de conexão inicializada 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 é criada, as propriedades de OleDbCommand leitura/gravação são definidas como 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 antes OleDbDataReader de executar um comando novo ou anterior.

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

Construtores

Nome	Description
OleDbCommand()	Inicializa uma nova instância da classe OleDbCommand.
OleDbCommand(String, OleDbConnection, OleDbTransaction)	Inicializa uma nova instância da OleDbCommand classe com o texto da consulta, um OleDbConnectione o Transaction.
OleDbCommand(String, OleDbConnection)	Inicializa uma nova instância da OleDbCommand classe com o texto da consulta e um OleDbConnection.
OleDbCommand(String)	Inicializa uma nova instância da OleDbCommand classe com o texto da consulta.

Propriedades

Nome	Description
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 CommandText propriedade é interpretada.
Connection	Obtém ou define o OleDbConnection usado por esta instância do OleDbCommand.
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.
Parameters	Obtém OleDbParameterCollection.
Transaction	Obtém ou define o OleDbTransaction interior no qual a OleDbCommand execução é executada.
UpdatedRowSource	Obtém ou define como os resultados do comando são aplicados ao DataRow quando usado pelo Update método do OleDbDataAdapter.

Métodos

Nome	Description
Cancel()	Tenta cancelar a execução de um OleDbCommand.
Clone()	Cria um novo OleDbCommand objeto que é uma cópia da instância atual.
CreateParameter()	Cria uma nova instância de um OleDbParameter objeto.
ExecuteNonQuery()	Executa uma instrução Connection SQL e retorna o número de linhas afetadas.
ExecuteReader()	Envia o CommandText para o Connection e cria um OleDbDataReader.
ExecuteReader(CommandBehavior)	Envia o CommandText para o Connectione cria um OleDbDataReader usando um dos CommandBehavior valores.
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.
Prepare()	Cria uma versão preparada (ou compilada) do comando na fonte de dados.
ResetCommandTimeout()	Redefine a CommandTimeout propriedade para o valor padrão.

Implantações explícitas de interface

Nome	Description
ICloneable.Clone()	Para obter uma descrição deste membro, consulte Clone().
IDbCommand.ExecuteReader()	Para obter uma descrição deste membro, consulte ExecuteReader().
IDbCommand.ExecuteReader(CommandBehavior)	Executa o CommandText contra e Connectioncria um usando um IDataReader dos CommandBehavior valores.

Confira também

• OleDbDataAdapter
• OleDbConnection
• Trabalhando com comandos