IDataAdapter Interface

Definition

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.Allows an object to implement a DataAdapter, and represents a set of methods and mapping action-related properties that are used to fill and update a DataSet and update a data source.

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.IDbDataAdapter instances are for data sources that are (or resemble) relational databases with textual commands (like Transact-SQL), while IDataAdapter instances could can use any type of data source.

public interface class IDataAdapter
public interface IDataAdapter
type IDataAdapter = interface
Public Interface IDataAdapter
Derived

Examples

L’exemple suivant utilise les classes dérivées, SqlCommand, SqlDataAdapteret SqlConnectionpour sélectionner des enregistrements à partir d’une base de données.The following example uses the derived classes, SqlCommand, SqlDataAdapter, and SqlConnection, to select records from a database. La DataSet remplie est ensuite retournée.The filled DataSet is then returned. Pour ce faire, la méthode reçoit un DataSetinitialisé, une chaîne de connexion et une chaîne de requête qui est une instruction Transact-SQL SELECT.To do this, the method is passed an initialized DataSet, a connection string, and a query string that is a Transact-SQL SELECT statement.

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

Remarks

L’interface IDataAdapter permet à une classe qui hérite d’implémenter une classe DataAdapter, qui représente le pont entre une source de données et une DataSet.The IDataAdapter interface allows an inheriting class to implement a DataAdapter class, which represents the bridge between a data source and a DataSet. Pour plus d’informations sur les classes DataAdapter, consultez remplissage d’un DataSet à partir d’un DataAdapter.For more information about DataAdapter classes, see Populating a DataSet from a 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.An application does not create an instance of the IDataAdapter interface directly, but implements an instance of a class that inherits IDataAdapter.

Les classes qui héritent de 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.Classes that inherit IDataAdapter must implement the inherited members, and they typically define additional members to add provider-specific functionality. Par exemple, l’interface IDataAdapter définit une méthode Fill qui prend un DataSet en tant que paramètre.For example, the IDataAdapter interface defines a Fill method that takes a DataSet as a parameter. À son tour, la classe OleDbDataAdapter hérite de la méthode Fill et définit également deux surcharges supplémentaires de la méthode Fill qui acceptent un objet Recordset ADO en tant que paramètre.In turn, the OleDbDataAdapter class inherits the Fill method and also defines two additional overloads of the Fill method that take an ADO Recordset object as a parameter.

Notes to Implementers

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 donné à toutes les classes dans un espace de noms de fournisseur de données .NET Framework spécifique.To promote consistency among .NET Framework data providers, name the inheriting class in the form Prv DataAdapter where Prv is the uniform prefix given to all classes in a specific .NET Framework data provider namespace. Par exemple, Sql est le préfixe de la classe SqlDataAdapter dans l’espace de noms System.Data.SqlClient.For example, Sql is the prefix of the SqlDataAdapter class in the System.Data.SqlClient namespace.

Lorsque vous héritez de l’interface IDataAdapter, vous devez implémenter les constructeurs suivants :When you inherit from the IDataAdapter interface, you should implement the following constructors:

ÉlémentItem DescriptionDescription
PrvDataAdapter()PrvDataAdapter() Initialise une nouvelle instance de la classe PrvDataAdapter.Initializes a new instance of the PrvDataAdapter class.
PrvDataAdapter (PrvCommand selectCommand)PrvDataAdapter(PrvCommand selectCommand) Initialise une nouvelle instance de la classe PrvDataAdapter à l’aide de l’instruction SQL SELECT spécifiée.Initializes a new instance of the PrvDataAdapter class by using the specified SQL SELECT statement.
PrvDataAdapter (String selectCommandText, String selectConnectionString)PrvDataAdapter(string selectCommandText, string selectConnectionString) Initialise une nouvelle instance de la classe PrvDataAdapter en utilisant une instruction SQL SELECT et une chaîne de connexion.Initializes a new instance of the PrvDataAdapter class by using an SQL SELECT statement and a connection string.
PrvDataAdapter (String selectCommandText, PrvConnection selectConnection)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.Initializes a new instance of the PrvDataAdapter class by using an SQL SELECT statement and a PrvConnection object.

Properties

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.Indicates or specifies whether unmapped source tables or columns are passed with their source names in order to be filtered or to raise an error.

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.Indicates or specifies whether missing source tables, columns, and their relationships are added to the dataset schema, ignored, or cause an error to be raised.

TableMappings

Indique la manière dont une table source est mappée à une table du groupe de données.Indicates how a source table is mapped to a dataset table.

Methods

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".Adds or updates rows in the DataSet to match those in the data source using the DataSet name, and creates a DataTable named "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é.Adds a DataTable named "Table" to the specified DataSet and configures the schema to match that in the data source based on the specified SchemaType.

GetFillParameters()

Obtient les paramètres définis par l'utilisateur lors de l'exécution d'une instruction SQL SELECT.Gets the parameters set by the user when executing an SQL SELECT statement.

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".Calls the respective INSERT, UPDATE, or DELETE statements for each inserted, updated, or deleted row in the specified DataSet from a DataTable named "Table".

Applies to