La interfaz IDbCommand permite que una clase heredada implemente una clase Command, que representa una instrucción SQL que se ejecuta en un origen de datos. Para obtener más información sobre las clases Command, vea Ejecutar un comando. Para obtener más información sobre la implementación de proveedores de datos de .NET Framework, vea Implementing a .NET Framework Data Provider.

Una aplicación no crea una instancia de la interfaz IDbCommand directamente, sino que la crea de una clase que hereda de IDbCommand.

Las clases que heredan IDbCommand deben implementar todos los miembros heredados y suelen definir miembros adicionales para agregar la funcionalidad específica de proveedor. Por ejemplo, la interfaz IDbCommand define el método ExecuteNonQuery. A su vez, la clase SqlCommand hereda este método y también define el método ExecuteXmlReader.

Notas para los implementadores Para potenciar la coherencia entre los proveedores de datos de .NET Framework, asigne a la clase heredada un nombre con el formato PrvClassname, donde Prv es el prefijo uniforme que se asigna a todas las clases de un espacio de nombres de proveedor de datos de .NET Framework específico. Por ejemplo, Sql es el prefijo de la clase SqlCommand en el espacio de nombres System.Data.SqlClient. Al heredar de la interfaz IDbCommand, se deben implementar los siguientes constructores:

En el ejemplo siguiente se crean instancias de las clases derivadas SqlConnection, SqlCommand y SqlDataReader. Posteriormente, se leen los datos y se escriben en la consola. Por último, el ejemplo cierra SqlDataReader y, a continuación, SqlConnection.

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

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();
        SqlDataReader reader = command.ExecuteReader();
        try
        {
            while (reader.Read())
            {
                Console.WriteLine(String.Format("{0}, {1}",
                    reader[0], reader[1]));
            }
        }
        finally
        {
            // Always call Close when done reading.
            reader.Close();
        }
    }
}

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium, Windows Mobile para Pocket PC, Windows Mobile para Smartphone, Windows Server 2003, Windows XP Media Center, Windows XP Professional x64, Windows XP SP2, Windows XP Starter Edition

.NET Framework no admite todas las versiones de cada plataforma. Para obtener una lista de las versiones admitidas, vea Requisitos del sistema.

.NET Framework

.NET Compact Framework