IDbCommand Interface

Definição

Espaço de Nomes:
System.Data
Assemblagem:
System.Data.dll
Assemblagem:
netstandard.dll

Representa uma instrução SQL que é executada enquanto está ligada a uma fonte de dados, e é implementada por fornecedores de dados .NET que acedem a bases 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 seguinte cria instâncias das classes derivadas, SqlConnection, SqlCommand, e SqlDataReader. O exemplo lê os dados, escrevendo-os na consola. Finalmente, o exemplo fecha o SqlDataReader, depois o 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

Observações

A IDbCommand interface permite que uma classe herdadora implemente uma classe Command, que representa uma instrução SQL executada numa fonte de dados. Para mais informações sobre classes de Comando, consulte Executar um Comando.

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

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

Notas para Implementadores

Para promover a consistência entre .NET fornecedores de dados do Framework, nomeie a classe herdeira na forma PrvClassname onde Prv é o prefixo uniforme dado a todas as classes num determinado espaço de nomes do fornecedor de dados .NET Framework. Por exemplo, Sql é o prefixo da SqlCommand classe no System.Data.SqlClient namespace.

Quando herdas da IDbCommand interface, deves implementar os seguintes construtores:

Número 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, ligação PrvConnection) Inicializa uma nova instância da classe PrvCommand com o texto da consulta e um PrvConnection.
PrvCommand(string cmdText, PrvConnection connection, PrvTransaction transaction) Inicializa uma nova instância da classe PrvCommand com o texto da consulta, um PrvConnection e o PrvTransaction.

Propriedades

Name Description
CommandText

Recebe ou define o comando de texto para ser executado contra a fonte de dados.
CommandTimeout

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

Indica ou especifica como a CommandText propriedade é interpretada.
Connection

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

Obtém o IDataParameterCollection.
Transaction

Obtém ou define a transação dentro da qual o objeto Command de um fornecedor de dados .NET executa.
UpdatedRowSource

Obtém ou define como os resultados dos comandos são aplicados ao DataRow quando usados pelo Update(DataSet) método de um DbDataAdapter.

Métodos

Name Description
Cancel()

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

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

Realiza tarefas definidas pela aplicação associadas à libertação, libertação ou reinício de recursos não geridos.

(Herdado de IDisposable)
ExecuteNonQuery()

Executa uma instrução SQL contra o objeto Connection de um fornecedor de dados .NET e devolve o número de linhas afetadas.
ExecuteReader()

Executa o CommandText contra o Connection e constrói um IDataReader.
ExecuteReader(CommandBehavior)

Executa o CommandText contra o Connection, e constrói um IDataReader usando um dos CommandBehavior valores.
ExecuteScalar()

Executa a consulta e devolve a primeira coluna da primeira linha do conjunto de resultados devolvida 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

Ver também