L'interface IDbCommand permet à une classe qui hérite d'implémenter une classe Command représentant une instruction SQL qui est exécutée au niveau d'une source de données. Pour plus d'informations sur les classes Command, consultez Exécution d'une commande. Pour plus d'informations sur l'implémentation de fournisseurs de données .NET Framework, consultez Implementing a .NET Framework Data Provider.

Une application ne crée pas directement d'instance de l'interface IDbCommand, mais crée une instance d'une classe qui hérite de IDbCommand.

Les classes qui héritent de IDbCommand doivent implémenter tous les membres hérités et définissent généralement des membres supplémentaires pour ajouter des fonctionnalités propres au fournisseur. Par exemple, l'interface IDbCommand définit la méthode ExecuteNonQuery. À son tour, la classe SqlCommand hérite de cette méthode et définit également la méthode ExecuteXmlReader.

Remarques à l'attention des implémenteurs Pour promouvoir la cohérence entre les fournisseurs de données .NET Framework, nommez la classe qui hérite sous la forme PrvClassname où Prv est le préfixe uniforme affecté à toutes les classes d'un espace de noms de fournisseurs de données .NET Framework spécifique. Par exemple, Sql est le préfixe de la classe SqlCommand dans l'espace de noms System.Data.SqlClient. Si vous héritez de l'interface IDbCommand, il est recommandé d'implémenter les constructeurs suivants :

L'exemple suivant crée des instances des classes dérivées (SqlConnection, SqlCommand et SqlDataReader). L'exemple lit les données, en les écrivant dans la console. Pour terminer, l'exemple ferme SqlDataReader, puis 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 Edition, Windows Mobile pour Pocket PC, Windows Mobile pour Smartphone, Windows Server 2003, Windows XP Édition Media Center, Windows XP Professionnel Édition x64, Windows XP SP2, Windows XP Starter Edition

Le .NET Framework ne prend pas en charge toutes les versions de chaque plate-forme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise.

.NET Framework

.NET Compact Framework