OleDbCommand Classe

Definição

Espaço de Nomes:: System.Data.OleDb

Assemblagem:: System.Data.dll

Importante

Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.

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

public ref class OleDbCommand sealed : System::ComponentModel::Component, ICloneable, IDisposable, System::Data::IDbCommand

public ref class OleDbCommand sealed : 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, IDisposable

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 Component
Implements ICloneable, IDbCommand, IDisposable

Public NotInheritable Class OleDbCommand
Inherits DbCommand
Implements ICloneable, IDisposable

Herança: Object

MarshalByRefObject

Component
OleDbCommand

Herança: Object

MarshalByRefObject

Component

DbCommand
OleDbCommand

Implementações: IDbCommand ICloneable IDisposable

Exemplos

O exemplo seguinte utiliza os OleDbCommand, along OleDbDataAdapter e OleDbConnection, para selecionar linhas de uma base de dados Access. O preenchimento DataSet é então devolvido. O exemplo recebe uma DataSet inicializada, uma cadeia de ligação, uma cadeia de consulta que é uma instrução SQL SELECT e uma cadeia que é o nome da tabela da base 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

Observações

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

OleDbCommand apresenta os seguintes métodos que executam comandos numa fonte de dados:

Número	Description
ExecuteReader	Executa comandos que devolvem linhas. ExecuteReader pode não ter o efeito desejado se usados para executar comandos como instruções SQL SET.
ExecuteNonQuery	Executa comandos como SQL INSERT, DELETE, UPDATE e instruções SET.
ExecuteScalar	Recupera um único valor, por exemplo, um valor agregado de uma base de dados.

Podes repor a CommandText propriedade e reutilizar o OleDbCommand objeto. No entanto, deve fechar antes OleDbDataReader de poder executar um comando novo ou anterior.

Se um OleDbException fatal (por exemplo, um nível de gravidade SQL Server de 20 ou superior) for gerado pelo método que executa um OleDbCommand, o OleDbConnection, a ligação pode ser encerrada. No entanto, o utilizador pode reabrir a ligação e continuar.

Construtores

Name	Description
OleDbCommand()	Inicializa uma nova instância da OleDbCommand classe.
OleDbCommand(String, OleDbConnection, OleDbTransaction)	Inicializa uma nova instância da OleDbCommand classe com o texto da consulta, um OleDbConnection, e 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

Name	Description
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 para serem executados na fonte de dados.
CommandTimeout	Obtém ou define o tempo de espera (em segundos) antes de terminar 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.
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	Fica com a coleção de DbParameter objetos. (Herdado de DbCommand)
DbTransaction	Obtém ou define o DbTransaction dentro do qual este DbCommand objeto executa. (Herdado de DbCommand)
DesignMode	Obtém um valor que indica se o Component está atualmente em modo de design. (Herdado de Component)
DesignTimeVisible	Recebe ou define um valor que indica se o objeto de comando deve ser visível num controlo personalizado do Windows Forms Designer.
Events	Obtém a lista de gestores de eventos que estão ligados a isto 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 dentro do qual executa OleDbCommand .
UpdatedRowSource	Obtém ou define como os resultados dos comandos são aplicados ao DataRow quando usados pelo `Update` método do OleDbDataAdapter.

Métodos

Name	Description
Cancel()	Tenta cancelar a execução de um OleDbCommand.
Clone()	Cria um novo OleDbCommand objeto que é uma cópia da instância atual.
CreateDbParameter()	Cria uma nova instância de um DbParameter objeto. (Herdado de DbCommand)
CreateObjRef(Type)	Cria um objeto que contém toda a informação relevante necessária para gerar um proxy usado para comunicar com um objeto remoto. (Herdado de MarshalByRefObject)
CreateParameter()	Cria uma nova instância de um OleDbParameter objeto.
Dispose()	Liberta todos os recursos utilizados pelo Component. (Herdado de Component)
Dispose(Boolean)	Liberta os recursos não geridos usados pelo Component e opcionalmente liberta os recursos geridos. (Herdado de Component)
Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
ExecuteDbDataReader(CommandBehavior)	Executa o comando contra a sua ligação, devolvendo um DbDataReader que pode ser usado para aceder aos resultados. (Herdado de DbCommand)
ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken)	Os fornecedores devem implementar este método para fornecer uma implementação não padrão para ExecuteReader sobrecargas. A implementação padrão invoca o método síncrono ExecuteReader() e devolve uma tarefa concluída, bloqueando a thread que chama. A implementação por defeito devolverá uma tarefa cancelada se for recebida um token de cancelamento já cancelado. As exceções lançadas pelo ExecuteReader serão comunicadas através da propriedade de Exceção de Tarefa devolvida. Este método aceita um token de cancelamento que pode ser usado para pedir que a operação seja cancelada antecipadamente. As implementações podem ignorar este pedido. (Herdado de DbCommand)
ExecuteNonQuery()	Executa uma instrução SQL contra o Connection e devolve o número de linhas afetadas.
ExecuteNonQueryAsync()	Uma versão assíncrona de ExecuteNonQuery(), que executa o comando contra o seu objeto de ligação, devolvendo o número de linhas afetadas. Invoca ExecuteNonQueryAsync(CancellationToken) com CancellationToken.None. (Herdado de DbCommand)
ExecuteNonQueryAsync(CancellationToken)	Esta é a versão assíncrona de ExecuteNonQuery(). Os prestadores devem sobrepor-se com uma implementação adequada. O token de cancelamento pode, opcionalmente, ser ignorado. A implementação padrão invoca o método síncrono ExecuteNonQuery() e devolve uma tarefa concluída, bloqueando a thread que chama. A implementação por defeito devolverá uma tarefa cancelada se for recebida um token de cancelamento já cancelado. As exceções lançadas por ExecuteNonQuery() serão comunicadas através da propriedade de Exceção de Tarefa devolvida. Não invoque outros métodos e propriedades do `DbCommand` objeto até que a tarefa devolvida esteja concluída. (Herdado de DbCommand)
ExecuteReader()	Envia o CommandText para e Connection constrói um OleDbDataReader.
ExecuteReader(CommandBehavior)	Envia o CommandText para o Connection, e constrói um OleDbDataReader usando um dos CommandBehavior valores.
ExecuteReaderAsync()	Uma versão assíncrona de ExecuteReader, que executa o comando contra a sua ligação, retornando a DbDataReader que pode ser usada para aceder aos resultados. Invoca ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken) com CancellationToken.None. (Herdado de DbCommand)
ExecuteReaderAsync(CancellationToken)	Uma versão assíncrona de ExecuteReader, que executa o comando contra a sua ligação, retornando a DbDataReader que pode ser usada para aceder aos resultados. Invoca ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken). (Herdado de DbCommand)
ExecuteReaderAsync(CommandBehavior, CancellationToken)	Invoca ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken). (Herdado de DbCommand)
ExecuteReaderAsync(CommandBehavior)	Uma versão assíncrona de ExecuteReader, que executa o comando contra a sua ligação, retornando a DbDataReader que pode ser usada para aceder aos resultados. Invoca ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken). (Herdado de DbCommand)
ExecuteScalar()	Executa a consulta e devolve a primeira coluna da primeira linha do conjunto de resultados devolvida pela consulta. Colunas ou linhas adicionais são ignoradas.
ExecuteScalarAsync()	Uma versão assíncrona de ExecuteScalar(), que executa o comando e devolve a primeira coluna da primeira linha do primeiro conjunto de resultados devolvido. 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 de ExecuteScalar(). Os prestadores devem sobrepor-se com uma implementação adequada. O token de cancelamento pode, opcionalmente, ser ignorado. A implementação padrão invoca o método síncrono ExecuteScalar() e devolve uma tarefa concluída, bloqueando a thread que chama. A implementação por defeito devolverá uma tarefa cancelada se for recebida um token de cancelamento já cancelado. As exceções lançadas pelo ExecuteScalar serão comunicadas através da propriedade de Exceção de Tarefa devolvida. Não invoque outros métodos e propriedades do `DbCommand` objeto até que a tarefa devolvida esteja concluída. (Herdado de DbCommand)
GetHashCode()	Serve como função de hash predefinida. (Herdado de Object)
GetLifetimeService()	Recupera o objeto de serviço de tempo de vida atual que controla a política de vida útil neste caso. (Herdado de MarshalByRefObject)
GetService(Type)	Devolve 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()	Obtém-se um objeto de serviço vitalício para controlar a apólice vitalícia neste caso. (Herdado de MarshalByRefObject)
MemberwiseClone()	Cria uma cópia superficial do atual Object. (Herdado de Object)
MemberwiseClone(Boolean)	Cria uma cópia superficial do objeto atual MarshalByRefObject . (Herdado de MarshalByRefObject)
Prepare()	Cria uma versão preparada (ou compilada) do comando na fonte de dados.
ResetCommandTimeout()	Reinicia a CommandTimeout propriedade para o valor padrão.
ToString()	Devolve a String contendo o nome do Component, se existir. Este método não deve ser ultrapassado. (Herdado de Component)

evento

Name	Description
Disposed	Ocorre quando o componente é eliminado por uma chamada ao Dispose() método. (Herdado de Component)

Implementações de Interface Explícita

Name	Description
ICloneable.Clone()	Para uma descrição deste elemento, veja Clone().
IDbCommand.Connection	Obtém ou define o IDbConnection usado por esta instância do IDbCommand. (Herdado de DbCommand)
IDbCommand.CreateParameter()	Esta API suporta a infraestrutura de produtos e não é pressuposta para ser utilizada diretamente a partir do seu código. Cria uma nova instância de um IDbDataParameter objeto.
IDbCommand.CreateParameter()	Cria uma nova instância de um IDbDataParameter objeto. (Herdado de DbCommand)
IDbCommand.ExecuteReader()	Para uma descrição deste elemento, veja ExecuteReader().
IDbCommand.ExecuteReader(CommandBehavior)	Executa o CommandText contra o Connection, e constrói um IDataReader usando um dos CommandBehavior valores.
IDbCommand.Parameters	Obtém o IDataParameterCollection. (Herdado de DbCommand)
IDbCommand.Transaction	Obtém ou define o DbTransaction dentro do qual este DbCommand objeto executa. (Herdado de DbCommand)

Aplica-se a

Ver também

Comentários

Esta página foi útil?