Cet article a fait l’objet d’une traduction automatique. Pour afficher l’article en anglais, activez la case d’option Anglais. Vous pouvez également afficher le texte anglais dans une fenêtre contextuelle en faisant glisser le pointeur de la souris sur le texte traduit.
Traduction
Anglais

IDataAdapter interface

 

Date de publication : novembre 2016

Permet à un objet d’implémenter DataAdapter et représente un ensemble de méthodes et propriétés liées au mappage servant à remplir et mettre à jour un DataSet et mettre à jour une source de données.

IDbDataAdapter les instances sont des sources de données (ou semblables) des bases de données relationnelles avec les commandes textuelles (comme Transact-SQL), tandis que IDataAdapter instances pourraient peuvent utiliser n’importe quel type de source de données.

Espace de noms:   System.Data
Assembly:  System.Data (dans System.Data.dll)

public interface IDataAdapter

NomDescription
System_CAPS_pubpropertyMissingMappingAction

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 générer une erreur.

System_CAPS_pubpropertyMissingSchemaAction

Indique ou spécifie si les tables sources manquants, les colonnes et leurs relations sont ajoutées au schéma du jeu de données, sont ignorées ou provoquent une erreur à signaler.

System_CAPS_pubpropertyTableMappings

Indique la manière dont une table source est mappée à une table de dataset.

NomDescription
System_CAPS_pubmethodFill(DataSet)

Ajoute ou met à jour des lignes dans la DataSet correspondre à ceux de la source de données à l’aide de la DataSet nommer et crée un DataTable nommé « Table ».

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

System_CAPS_pubmethodGetFillParameters()

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

System_CAPS_pubmethodUpdate(DataSet)

Appelle les instructions INSERT, UPDATE ou DELETE respectives pour chaque insérés, mis à jour ou supprimé des lignes dans la DataSet d’un DataTable nommé « Table ».

Le IDataAdapter interface permet à une classe qui hérite d’implémenter une classe DataAdapter représentant 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 une instance de la IDataAdapter interface directement, mais implémente une instance d’une classe qui hérite de IDataAdapter.

Les classes qui héritent IDataAdapter 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, le IDataAdapter interface définit un Fill méthode qui prend un DataSet en tant que paramètre. À son tour, le 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 ADO Recordset comme paramètre.

Remarques à l’attention des implémenteurs :

Pour promouvoir la cohérence entre les fournisseurs de données .NET Framework, nommez la classe qui hérite sous la forme Prv DataAdapter où Prv est le préfixe uniforme affecté à 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 le System.Data.SqlClient espace de noms.

Lorsque vous héritez de la IDataAdapter interface, vous devez implémenter les constructeurs suivants :

Élément

Description

PrvDataAdapter()

Initialise une nouvelle instance de la classe PrvDataAdapter.

PrvDataAdapter (selectCommand PrvCommand)

Initialise une nouvelle instance de la classe PrvDataAdapter en utilisant l’instruction SQL SELECT spécifiée.

PrvDataAdapter (selectCommandText de chaîne, chaîne selectConnectionString)

Initialise une nouvelle instance de la classe PrvDataAdapter en utilisant une instruction SQL SELECT et une chaîne de connexion.

PrvDataAdapter (chaîne selectCommandText, PrvConnection selectConnection)

Initialise une nouvelle instance de la classe PrvDataAdapter en utilisant une instruction SQL SELECT et un objet PrvConnection.

L’exemple suivant utilise les classes dérivées, SqlCommand, SqlDataAdapter, et SqlConnection, pour sélectionner des enregistrements à partir d’une base de données. La pleine DataSet est alors retournée. Pour ce faire, est passé à la méthode 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;
    }
}

.NET Framework
Disponible depuis 1.1
Retour au début
Afficher: