IDbCommand Interface

Définition

public interface class IDbCommand : IDisposable

public interface IDbCommand : IDisposable

type IDbCommand = interface
    interface IDisposable

Public Interface IDbCommand
Implements IDisposable

Dérivé

System.Data.Common.DbCommand

System.Data.Odbc.OdbcCommand

System.Data.OleDb.OleDbCommand

System.Data.OracleClient.OracleCommand

System.Data.SqlClient.SqlCommand

Implémente

IDisposable

Exemples

L’exemple suivant crée des instances des classes dérivées, SqlConnection, SqlCommandet SqlDataReader. L’exemple lit les données et les écrit dans la console. Enfin, l’exemple ferme le SqlDataReader, puis le 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

Remarques

L’interface IDbCommand permet à une classe héritée d’implémenter une classe Command, qui représente une instruction SQL exécutée sur une source de données. Pour plus d’informations sur les classes command, consultez Exécution d’une commande.

Une application ne crée pas directement de instance de l’interfaceIDbCommand, mais crée un instance d’une classe qui implémente l’interfaceIDbCommand.

Les classes qui implémentent IDbCommand doivent implémenter tous ses membres et définir généralement des membres supplémentaires pour ajouter des fonctionnalités spécifiques au fournisseur. Par exemple, l’interface IDbCommand définit la ExecuteNonQuery méthode . À son tour, la SqlCommand classe hérite de cette méthode et définit également la ExecuteXmlReader méthode .

Notes pour les responsables de l’implémentation

Pour promouvoir la cohérence entre les fournisseurs de données .NET Framework, nommez la classe héritée sous la forme PrvClassname où Prv est le préfixe uniforme donné à toutes les classes dans un espace de noms de fournisseur de données .NET Framework spécifique. Par exemple, Sql est le préfixe de la SqlCommand classe dans l’espace de System.Data.SqlClient noms .

Lorsque vous héritez de l’interface IDbCommand , vous devez implémenter les constructeurs suivants :

Propriétés

Méthodes

S’applique à

Voir aussi

• DbDataAdapter
• IDbConnection
• OleDbCommand
• SqlCommand