IDbDataAdapter IDbDataAdapter IDbDataAdapter IDbDataAdapter Interface

Définition

Représente un jeu de propriétés liées à des commandes qui sont utilisées pour remplir DataSet et mettre à jour une source de données, et est implémenté par les fournisseurs de données .NET Framework qui accèdent à des bases de données relationnelles.Represents a set of command-related properties that are used to fill the DataSet and update a data source, and is implemented by .NET Framework data providers that access relational databases.

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 SqlCommand, SqlDataAdapter et SqlConnection, pour sélectionner des enregistrements à partir d’une source de données.The following example uses the derived classes, SqlCommand, SqlDataAdapter and SqlConnection, to select records from a data source. Le rempli DataSet est ensuite retourné.The filled DataSet is then returned. Pour ce faire, la méthode reçoit un initialisé DataSet, une chaîne de connexion et une chaîne de requête qui est une instruction Transact-SQL SELECT.To accomplish 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

Remarques

L' IDbDataAdapter interface hérite de l' IDataAdapter interface et permet à un objet de créer un DataAdapter conçu pour une utilisation avec une base de données relationnelle.The IDbDataAdapter interface inherits from the IDataAdapter interface and allows an object to create a DataAdapter designed for use with a relational database. L' IDbDataAdapter interface et, éventuellement, la classe utilitaire, DbDataAdapter, permettent à une classe qui hérite d’implémenter une classe DataAdapter, qui représente le pont entre une source de DataSetdonnées et un.The IDbDataAdapter interface and, optionally, the utility class, DbDataAdapter, allow 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. Pour plus d’informations sur l’implémentation des fournisseurs de données .NET Framework, consultez implémentation d’un Fournisseur de données .NET Framework.For more information about implementing .NET Framework data providers, see Implementing a .NET Framework Data Provider.

Une application ne crée pas directement une instance de IDbDataAdapter l’interface, mais crée une instance d’une classe qui IDbDataAdapter hérite de DbDataAdapteret.An application does not create an instance of the IDbDataAdapter interface directly, but creates an instance of a class that inherits IDbDataAdapter and DbDataAdapter.

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

Notes pour les responsables de l’implémentation

Pour promouvoir la cohérence entre .NET Framework fournisseurs de données, nommez la classe qui hérite sous Prv la forme Prv DataAdapter, où 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 SqlDataAdapter la classe dans System.Data.SqlClient l’espace de noms.For example, Sql is the prefix of the SqlDataAdapter class in the System.Data.SqlClient namespace.

Lorsque vous héritez de IDbDataAdapter l’interface, vous devez implémenter les constructeurs suivants:When you inherit from the IDbDataAdapter 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 avec l’instruction SQL SELECT spécifiée.Initializes a new instance of the PrvDataAdapter class with the specified SQL SELECT statement.

PrvDataAdapter (String selectCommandText, String selectConnectionString)PrvDataAdapter(string selectCommandText, string selectConnectionString) Initialise une nouvelle instance de la classe PrvDataAdapter avec une instruction SQL SELECT et une chaîne de connexion.Initializes a new instance of the PrvDataAdapter class with 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 avec une instruction SQL SELECT et un objet PrvConnection.Initializes a new instance of the PrvDataAdapter class with an SQL SELECT statement and a PrvConnection object.

Propriétés

DeleteCommand DeleteCommand DeleteCommand DeleteCommand

Obtient ou définit une instruction SQL permettant de supprimer les enregistrements du groupe de données.Gets or sets an SQL statement for deleting records from the data set.

InsertCommand InsertCommand InsertCommand InsertCommand

Obtient ou définit une instruction SQL utilisée pour insérer de nouveaux enregistrements dans la source de données.Gets or sets an SQL statement used to insert new records into the data source.

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

(Inherited from IDataAdapter)
MissingSchemaAction MissingSchemaAction MissingSchemaAction 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.

(Inherited from IDataAdapter)
SelectCommand SelectCommand SelectCommand SelectCommand

Obtient ou définit une instruction SQL utilisée pour sélectionner des enregistrements dans la source de données.Gets or sets an SQL statement used to select records in the data source.

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

(Inherited from IDataAdapter)
UpdateCommand UpdateCommand UpdateCommand UpdateCommand

Obtient ou définit une instruction SQL utilisée pour mettre à jour les enregistrements dans la source de données.Gets or sets an SQL statement used to update records in the data source.

Méthodes

Fill(DataSet) Fill(DataSet) Fill(DataSet) 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".

(Inherited from IDataAdapter)
FillSchema(DataSet, SchemaType) FillSchema(DataSet, SchemaType) FillSchema(DataSet, SchemaType) 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.

(Inherited from IDataAdapter)
GetFillParameters() GetFillParameters() GetFillParameters() 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.

(Inherited from IDataAdapter)
Update(DataSet) Update(DataSet) Update(DataSet) 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".

(Inherited from IDataAdapter)

S’applique à