IDbCommand Interface

Definição

Representa uma instrução SQL que é executada enquanto está conectada a uma fonte de dados e que é implementada por provedores de dados .NET Framework que acessam bancos de dados relacionais.Represents an SQL statement that is executed while connected to a data source, and is implemented by .NET Framework data providers that access relational databases.

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

Exemplos

O exemplo a seguir cria instâncias das classes derivadas, SqlConnection, SqlCommande SqlDataReader.The following example creates instances of the derived classes, SqlConnection, SqlCommand, and SqlDataReader. O exemplo lê os dados, gravando-os no console.The example reads through the data, writing it to the console. Por fim, o exemplo fecha o SqlDataReader e, em seguida, o SqlConnection.Finally, the example closes the SqlDataReader, then the 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 interface IDbCommand permite que uma classe de herança implemente uma classe Command, que representa uma instrução SQL executada em uma fonte de dados.The IDbCommand interface enables an inheriting class to implement a Command class, which represents an SQL statement that is executed at a data source. Para obter mais informações sobre classes de comando, consulte executando um comando.For more information about Command classes, see Executing a Command.

Um aplicativo não cria uma instância da interface de IDbCommand diretamente, mas cria uma instância de uma classe que implementa a interface IDbCommand.An application does not create an instance of the IDbCommand interface directly, but creates an instance of a class that implements the IDbCommand interface.

As classes que implementam IDbCommand devem implementar todos os seus membros e normalmente definem membros adicionais para adicionar funcionalidade específica do provedor.Classes that implement IDbCommand must implement all its members, and typically define additional members to add provider-specific functionality. Por exemplo, a interface IDbCommand define o método ExecuteNonQuery.For example, the IDbCommand interface defines the ExecuteNonQuery method. Por sua vez, a classe SqlCommand herda esse método e também define o método ExecuteXmlReader.In turn, the SqlCommand class inherits this method, and also defines the ExecuteXmlReader method.

Notas aos Implementadores

Para promover a consistência entre .NET Framework provedores de dados, nomeie a classe herdeira no formulário PrvClassname em que Prv é o prefixo uniforme fornecido a todas as classes em um namespace específico do provedor de dados .NET Framework.To promote consistency among .NET Framework data providers, name the inheriting class in the form PrvClassname where Prv is the uniform prefix given to all classes in a specific .NET Framework data provider namespace. Por exemplo, Sql é o prefixo da classe SqlCommand no namespace System.Data.SqlClient.For example, Sql is the prefix of the SqlCommand class in the System.Data.SqlClient namespace.

Ao herdar da interface IDbCommand, você deve implementar os seguintes construtores:When you inherit from the IDbCommand interface, you should implement the following constructors:

ItemItem DescriçãoDescription
PrvCommand()PrvCommand() Inicializa uma nova instância da classe PrvCommand.Initializes a new instance of the PrvCommand class.
PrvCommand (cadeia de Caracteres cmdText)PrvCommand(string cmdText) Inicializa uma nova instância da classe PrvCommand com o texto da consulta.Initializes a new instance of the PrvCommand class with the text of the query.
PrvCommand (cadeia de Caracteres cmdText, conexão PrvConnection)PrvCommand(string cmdText, PrvConnection connection) Inicializa uma nova instância da classe PrvCommand com o texto da consulta e um PrvConnection.Initializes a new instance of the PrvCommand class with the text of the query and a PrvConnection.
PrvCommand (cadeia de Caracteres cmdText, conexão PrvConnection, PrvTransaction transação)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.Initializes a new instance of the PrvCommand class with the text of the query, a PrvConnection, and the PrvTransaction.

Propriedades

CommandText

Obtém ou define o comando de texto a ser executado na fonte de dados.Gets or sets the text command to run against the data source.

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.Gets or sets the wait time (in seconds) before terminating the attempt to execute a command and generating an error.

CommandType

Indica ou especifica como a propriedade CommandText é interpretada.Indicates or specifies how the CommandText property is interpreted.

Connection

Obtém ou define o IDbConnection usado por essa instância do IDbCommand.Gets or sets the IDbConnection used by this instance of the IDbCommand.

Parameters

Obtém o IDataParameterCollection.Gets the IDataParameterCollection.

Transaction

Obtém ou define a transação na qual um objeto Command de um provedor de dados .NET Framework é executado.Gets or sets the transaction within which the Command object of a .NET Framework data provider executes.

UpdatedRowSource

Obtém ou define como os resultados do comando são aplicados a DataRow quando usados pelo método Update(DataSet) de DbDataAdapter.Gets or sets how command results are applied to the DataRow when used by the Update(DataSet) method of a DbDataAdapter.

Métodos

Cancel()

Tenta cancelar a execução de um IDbCommand.Attempts to cancels the execution of an IDbCommand.

CreateParameter()

Cria uma nova instância de um objeto IDbDataParameter.Creates a new instance of an IDbDataParameter object.

Dispose()

Realiza tarefas definidas pelo aplicativo associadas à liberação ou à redefinição de recursos não gerenciados.Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources.

(Herdado de IDisposable)
ExecuteNonQuery()

Executa uma instrução SQL no objeto Connection de um provedor de dados .NET Framework e retorna o número de linhas afetadas.Executes an SQL statement against the Connection object of a .NET Framework data provider, and returns the number of rows affected.

ExecuteReader()

Executa o CommandText no Connection e compila um IDataReader.Executes the CommandText against the Connection and builds an IDataReader.

ExecuteReader(CommandBehavior)

Executa o CommandText para o Connection e cria um IDataReader usando um dos valores de CommandBehavior.Executes the CommandText against the Connection, and builds an IDataReader using one of the CommandBehavior values.

ExecuteScalar()

Executa a consulta e retorna a primeira coluna da primeira linha no conjunto de resultados retornado pela consulta.Executes the query, and returns the first column of the first row in the resultset returned by the query. Colunas ou linhas extra são ignoradas.Extra columns or rows are ignored.

Prepare()

Cria uma versão preparada (ou compilada) do comando na fonte de dados.Creates a prepared (or compiled) version of the command on the data source.

Aplica-se a

Veja também