Cette documentation est archivée et n’est pas conservée.

IDataAdapter, interface

Permet à un objet d'implémenter DataAdapter et représente un jeu de méthodes ainsi que de propriétés liées au mappage servant à remplir et à actualiser DataSet ainsi qu'à mettre à jour une source de données.

Espace de noms : System.Data
Assembly : System.Data (dans system.data.dll)

public interface IDataAdapter
public interface IDataAdapter
public interface IDataAdapter

L'interface IDataAdapter permet à 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 implémente une instance d'une classe qui hérite de IDbDataAdapter.

Les classes qui héritent de IDataAdapter 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 IDataAdapter définit une méthode Fill qui prend DataSet comme paramètre. À son tour, la classe OleDbDataAdapter hérite 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 IDataAdapter, il est recommandé d'implémenter les constructeurs suivants :

Élément

Description

PrvDataAdapter()

Initialise une nouvelle instance de la classe PrvDataAdapter.

PrvDataAdapter(PrvCommand selectCommand)

Initialise une nouvelle instance de la classe PrvDataAdapter avec l'instruction SQL SELECT spécifiée.

PrvDataAdapter(string selectCommandText, string selectConnectionString)

Initialise une nouvelle instance de la classe PrvDataAdapter avec une instruction SQL SELECT et une chaîne de connexion.

PrvDataAdapter(string selectCommandText, PrvConnection selectConnection)

Initialise une nouvelle instance de la classe PrvDataAdapter avec une instruction SQL SELECT et un objet PrvConnection.

L'exemple suivant utilise les classes dérivées (SqlCommand, SqlDataAdapter et SqlConnection) pour sélectionner des enregistrements à partir d'une base 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.

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

Prise en charge dans : 2.0, 1.1, 1.0

.NET Compact Framework

Prise en charge dans : 2.0, 1.0
Afficher: