IDbDataAdapter Interface

Définition

Espace de noms:

System.Data

Assembly:

System.Data.Common.dll

Représente un jeu de propriétés liées à des commandes qui servent à remplir le DataSet et à mettre à jour une source de données ; est implémenté par les fournisseurs de données .NET qui accèdent aux bases de données relationnelles.

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 , SqlDataAdapterSqlConnectionpour sélectionner des enregistrements à partir d’une source de données. Le rempli DataSet est ensuite retourné. Pour ce faire, la méthode est passée à un initialisé DataSet, un chaîne de connexion et une chaîne de requête qui est une instruction Transact-SQL SELECT.

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 , DbDataAdapterautorisent une classe héritée à 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 directement de instance de l’interfaceIDbDataAdapter, mais crée un instance d’une classe qui hérite de IDbDataAdapter 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 Recordset ADO 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 dans 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 :

É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.

Propriétés

DeleteCommand	Obtient ou définit une instruction SQL permettant de supprimer les enregistrements du groupe de données.
InsertCommand	Obtient ou définit une instruction SQL utilisée pour insérer de nouveaux enregistrements dans la source de données.
MissingMappingAction	Indique ou spécifie si les tables ou colonnes source non mappées sont passées avec leurs noms source afin d'être filtrées ou de déclencher une erreur. (Hérité de IDataAdapter)
MissingSchemaAction	Indique ou spécifie si les tables et les colonnes source absentes, ainsi que leurs relations, sont ajoutées au schéma du groupe de données, sont ignorées ou déclenchent une erreur. (Hérité de IDataAdapter)
SelectCommand	Obtient ou définit une instruction SQL utilisée pour sélectionner des enregistrements dans la source de données.
TableMappings	Obtient une collection qui indique comment une table source est mappée à une table de jeu de données. (Hérité de IDataAdapter)
UpdateCommand	Obtient ou définit une instruction SQL utilisée pour mettre à jour les enregistrements dans la source de données.

Méthodes

Fill(DataSet)	Ajoute ou met à jour les lignes de DataSet pour correspondre à celles de la source de données à l'aide du nom DataSet et crée un DataTable appelé "Table". (Hérité de IDataAdapter)
FillSchema(DataSet, SchemaType)	Ajoute un DataTable appelé "Table" au DataSet spécifié et configure le schéma pour qu'il corresponde à celui de la source de données en se basant sur le SchemaType spécifié. (Hérité de IDataAdapter)
GetFillParameters()	Obtient les paramètres définis par l'utilisateur lors de l'exécution d'une instruction SQL SELECT. (Hérité de IDataAdapter)
Update(DataSet)	Appelle les instructions INSERT, UPDATE ou DELETE respectives pour chaque ligne insérée, mise à jour ou supprimée dans le DataSet spécifié à partir d'un DataTable appelé "Table". (Hérité de IDataAdapter)