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, SqlCommandet SqlDataAdapter, pour SqlConnectionsélectionner des enregistrements d’une base 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 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 IDataAdapter.

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 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 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 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 SELECT SQL 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 SELECT SQL 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 dataset.

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

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 à