IDataAdapter Interface

Définition

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 à mettre à jour DataSet ainsi qu'à mettre à jour une source de données.

Les instances IDbDataAdapter sont destinées aux sources de données qui sont (ou ressemblent à) des bases de données relationnelles avec des commandes textuelles (comme Transact-SQL) alors que les instances IDataAdapter peuvent utiliser n’importe quel type de source de données.

public interface class IDataAdapter
public interface IDataAdapter
type IDataAdapter = interface
Public Interface IDataAdapter
Dérivé

Exemples

L’exemple suivant utilise les classes dérivées, SqlCommand, SqlDataAdapteret SqlConnectionpour sélectionner des enregistrements à partir d’une base de données. Le rempli DataSet est ensuite retourné. Pour ce faire, la méthode est passée à un initialisé DataSet, 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 IDataAdapter permet à 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.

Une application ne crée pas directement une instance de l’interface IDataAdapter , mais implémente une instance d’une classe qui hérite IDataAdapterde .

Les classes qui héritent IDataAdapter doivent implémenter les membres hérités, et elles définissent généralement des membres supplémentaires pour ajouter des fonctionnalités spécifiques au fournisseur. Par exemple, l’interface IDataAdapter définit une Fill méthode qui prend un DataSet comme paramètre. À son tour, la OleDbDataAdapter classe hérite 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 IDataAdapter , 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 à l’aide de l’instruction SQL SELECT spécifiée.
PrvDataAdapter(string selectCommandText, string selectConnectionString) Initialise une nouvelle instance de la classe PrvDataAdapter à l’aide d’une instruction SQL SELECT et d’une chaîne de connexion.
PrvDataAdapter(string selectCommandText, PrvConnection selectConnection) Initialise une nouvelle instance de la classe PrvDataAdapter à l’aide d’une instruction SQL SELECT et d’un objet PrvConnection.

Propriétés

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.

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.

TableMappings

Obtient une collection qui indique comment une table source est mappée à une table de jeu 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".

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

GetFillParameters()

Obtient les paramètres définis par l'utilisateur lors de l'exécution d'une instruction SQL SELECT.

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

S’applique à