IDbCommand Interface

  • Referência

Definição

Namespace:
System.Data
Assembly:
System.Data.Common.dll
Assembly:
System.Data.dll
Assembly:
netstandard.dll

Representa uma instrução SQL que é executada enquanto está conectada a uma fonte de dados e que é implementada por provedores de dados .NET que acessam bancos de dados relacionais.

public interface class IDbCommand : IDisposable
public interface IDbCommand : IDisposable
type IDbCommand = interface
    interface IDisposable
Public Interface IDbCommand
Implements IDisposable
Derivado
Implementações
IDisposable

Exemplos

O exemplo a seguir cria instâncias das classes derivadas, SqlConnectionSqlCommande SqlDataReader. O exemplo lê os dados, gravando-os no console. Por fim, o exemplo fecha o SqlDataReader.SqlConnection

private static void ReadOrderData(string connectionString)
{
    string queryString =
        "SELECT OrderID, CustomerID FROM dbo.Orders;";
    using (SqlConnection connection = new SqlConnection(
               connectionString))
    {
        SqlCommand command = new SqlCommand(
            queryString, connection);
        connection.Open();
        using(SqlDataReader reader = command.ExecuteReader())
        {
            while (reader.Read())
            {
                Console.WriteLine(String.Format("{0}, {1}",
                    reader[0], reader[1]));
            }
        }
    }
}

Public Sub ReadOrderData(ByVal connectionString As String)
    Dim queryString As String = _
        "SELECT OrderID, CustomerID FROM dbo.Orders;"
    Using connection As New SqlConnection(connectionString)
        Dim command As New SqlCommand(queryString, connection)
        connection.Open()
        Dim reader As SqlDataReader = command.ExecuteReader()
        Try
            While reader.Read()
                Console.WriteLine(String.Format("{0}, {1}", _
                    reader(0), reader(1)))
            End While
        Finally
            ' Always call Close when done reading.
            reader.Close()
        End Try
    End Using
End Sub

Comentários

A IDbCommand interface permite que uma classe herdada implemente uma classe Command, que representa uma instrução SQL executada em uma fonte de dados. Para obter mais informações sobre classes de comando, consulte Executando um comando.

Um aplicativo não cria uma instância da IDbCommand interface diretamente, mas cria uma instância de uma classe que implementa a IDbCommand interface.

As classes implementadas IDbCommand devem implementar todos os seus membros e, normalmente, definir membros adicionais para adicionar funcionalidades específicas do provedor. Por exemplo, a IDbCommand interface define o ExecuteNonQuery método. Por sua vez, a SqlCommand classe herda esse método e também define o ExecuteXmlReader método.

Notas aos Implementadores

Para promover a consistência entre .NET Framework provedores de dados, nomeie a classe herdada no formulário PrvClassname Prv em que é o prefixo uniforme fornecido a todas as classes em um namespace específico do provedor de dados .NET Framework. Por exemplo, Sql é o prefixo da SqlCommand classe no System.Data.SqlClient namespace.

Ao herdar da IDbCommand interface, você deve implementar os seguintes construtores:

Item Descrição
PrvCommand() Inicializa uma nova instância da classe PrvCommand.
PrvCommand(string cmdText) Inicializa uma nova instância da classe PrvCommand com o texto da consulta.
PrvCommand(string cmdText, conexão PrvConnection) Inicializa uma nova instância da classe PrvCommand com o texto da consulta e um PrvConnection.
PrvCommand(string cmdText, conexão PrvConnection, transação PrvTransaction) Inicializa uma nova instância da classe PrvCommand com o texto da consulta, um PrvConnection e o PrvTransaction.

Propriedades

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 um comando e antes de gerar um erro.
CommandType

Indica ou especifica como a propriedade CommandText é interpretada.
Connection

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

Obtém o IDataParameterCollection.
Transaction

Obtém ou define a transação na qual um objeto Command de um provedor de dados .NET é executado.
UpdatedRowSource

Obtém ou define como os resultados do comando são aplicados a DataRow quando usados pelo método Update(DataSet) de DbDataAdapter.

Métodos

Cancel()

Tenta cancelar a execução de um IDbCommand.
CreateParameter()

Cria uma nova instância de um objeto IDbDataParameter.
Dispose()

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

(Herdado de IDisposable)
ExecuteNonQuery()

Executa uma instrução SQL no objeto Connection de um provedor de dados .NET e retorna o número de linhas afetadas.
ExecuteReader()

Executa o CommandText no Connection e compila um IDataReader.
ExecuteReader(CommandBehavior)

Executa o CommandText para o Connection e cria um IDataReader usando um dos valores de CommandBehavior.
ExecuteScalar()

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

Cria uma versão preparada (ou compilada) do comando na fonte de dados.

Aplica-se a

Confira também