L'interface IDbDataAdapter hérite de l'interface IDataAdapter et permet à un objet de créer un DataAdapter conçu pour être utilisé avec une base de données relationnelle. L'interface IDbDataAdapter et éventuellement la classe d'utilitaire (DbDataAdapter) permettent à une classe qui hérite d'implémenter une classe DataAdapter représentant le pont entre une source de données et DataSet. Pour plus d'informations sur les classes DataAdapter, consultez Remplissage d'un DataSet à partir d'un DataAdapter. 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 IDbDataAdapter, mais crée une instance d'une classe qui hérite de IDbDataAdapter et de DbDataAdapter.

Les classes qui héritent de IDbDataAdapter doivent implémenter 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 IDbDataAdapter définit la propriété SelectCommand, et l'interface DbDataAdapter définit une méthode Fill qui prend DataTable comme paramètre. À son tour, la classe OleDbDataAdapter hérite de la propriété SelectCommand ainsi que de la méthode Fill, et définit également deux surcharges supplémentaires de la méthode Fill qui prennent un objet ADO Recordset comme paramètre.

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 Prv DataAdapter, 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 SqlDataAdapter dans l'espace de noms System.Data.SqlClient. Si vous héritez de l'interface IDbDataAdapter, il est recommandé d'implémenter les constructeurs suivants :

L'exemple suivant utilise les classes dérivées (SqlCommand, SqlDataAdapter et SqlConnection) pour sélectionner des enregistrements à partir d'une source de données. Le DataSet rempli est ensuite retourné. Pour effectuer cette opération, un DataSet initialisé, une chaîne de connexion et une chaîne de requête qui est une instruction Transact-SQL SELECT sont passés à la méthode.

Public Function SelectRows( _
    ByVal dataSet As DataSet, ByVal connectionString As String, _
    ByVal queryString As String) As DataSet

    Using connection As New SqlConnection(connectionString)
        Dim adapter As New SqlDataAdapter()
        adapter.SelectCommand = New SqlCommand( _
            queryString, connection)
        adapter.Fill(dataSet)
        Return dataSet
    End Using
End Function

private static DataSet SelectRows(DataSet dataset,
    string connectionString,string queryString) 
{
    using (SqlConnection connection = 
        new SqlConnection(connectionString))
    {
        SqlDataAdapter adapter = new SqlDataAdapter();
        adapter.SelectCommand = new SqlCommand(
            queryString, connection);
        adapter.Fill(dataset);
        return dataset;
    }
}

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