IDbDataAdapter Interface

Définition

public interface class IDbDataAdapter : System::Data::IDataAdapter

public interface IDbDataAdapter : System.Data.IDataAdapter

type IDbDataAdapter = interface
    interface IDataAdapter

Public Interface IDbDataAdapter
Implements IDataAdapter

Dérivé

System.Data.Common.DbDataAdapter

System.Data.Odbc.OdbcDataAdapter

System.Data.OleDb.OleDbDataAdapter

System.Data.OracleClient.OracleDataAdapter

System.Data.SqlClient.SqlDataAdapter

Implémente

IDataAdapter

Exemples

L’exemple suivant utilise les classes dérivées , SqlCommandet SqlConnection, SqlDataAdapter pour sélectionner des enregistrements à partir d’une source de données. Le rempli DataSet est ensuite retourné. Pour ce faire, la méthode passe une chaîne de connexion initialisée DataSetet une chaîne de requête qui est une instruction SELECT Transact-SQL.

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;
    }
}

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

Remarques

L’interface IDbDataAdapter hérite de l’interface IDataAdapter et permet à un objet de créer un DataAdapter conçu pour une utilisation avec une base de données relationnelle. L’interface IDbDataAdapter et, éventuellement, la classe utilitaire , DbDataAdapterpermettent à une classe héritée d’implémenter une classe DataAdapter, qui représente le pont entre une source de données et un 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 Implémentation d’un fournisseur de données .NET Framework.

Une application ne crée pas d’instance de l’interface IDbDataAdapter directement, mais crée une instance d’une classe qui hérite IDbDataAdapter de et DbDataAdapter.

Les classes qui héritent IDbDataAdapter doivent implémenter les membres hérités et généralement définir des membres supplémentaires pour ajouter des fonctionnalités spécifiques au fournisseur. Par exemple, l’interface IDbDataAdapter définit la SelectCommand propriété et l’interface DbDataAdapter définit une Fill méthode qui prend un DataTable comme paramètre. À son tour, la OleDbDataAdapter classe hérite de la SelectCommand propriété et de la Fill méthode, et définit également deux surcharges supplémentaires de la Fill méthode qui prennent un objet ADO Recordset comme paramètre.

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 Prv DataAdapter, où Prv est le préfixe uniforme donné à toutes les classes d’un espace de noms de fournisseur de données .NET Framework spécifique. Par exemple, Sql est le préfixe de la SqlDataAdapter classe dans l’espace de System.Data.SqlClient noms.

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

Propriétés

Méthodes

S’applique à