IDbDataAdapter Interface

Définition

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é
Implémente

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 :

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

S’applique à