IDbDataAdapter Interface

Référence

Définition

Espace de noms:: System.Data

Assembly:: System.Data.Common.dll

Assembly:: System.Data.dll

Assembly:: netstandard.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

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, SqlCommand SqlDataAdapter et SqlConnection, pour sélectionner des enregistrements à partir d’une source de données. Le remplissage DataSet est ensuite retourné. Pour ce faire, la méthode est passée à une chaîne de connexion initialiséeDataSet, une 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 .NET Framework fournisseurs de données, consultez Implémentation d’un .NET Framework Fournisseur de données.

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

Les classes qui héritent IDbDataAdapter doivent implémenter les membres hérités et définissent généralement 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 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 acceptent un objet Recordset ADO en tant que paramètre.

Notes pour les responsables de l’implémentation

Pour promouvoir la cohérence entre .NET Framework fournisseurs de données, 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 System.Data.SqlClient de 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 SELECT SQL spécifiée.
PrvDataAdapter(string selectCommandText, string selectConnectionString)	Initialise une nouvelle instance de la classe PrvDataAdapter avec une instruction SELECT SQL et une chaîne de connexion.
PrvDataAdapter(string selectCommandText, PrvConnection selectConnection)	Initialise une nouvelle instance de la classe PrvDataAdapter avec une instruction SELECT SQL 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 dataset. (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 nommé « Table » au DataSet spécifié et configure le schéma pour qu’il corresponde à celui de la source de données en fonction du 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)

S’applique à