DbDataAdapter Classe

Définition

Aide l'implémentation de l'interface IDbDataAdapter.Aids implementation of the IDbDataAdapter interface. Les héritiers de DbDataAdapter implémentent un ensemble de fonctions pour fournir un typage fort, mais héritent de la plupart des fonctionnalités nécessaires à l’implémentation complète deDataAdapter.Inheritors of DbDataAdapter implement a set of functions to provide strong typing, but inherit most of the functionality needed to fully implement a DataAdapter.

public ref class DbDataAdapter abstract : System::Data::Common::DataAdapter, ICloneable, System::Data::IDbDataAdapter
public abstract class DbDataAdapter : System.Data.Common.DataAdapter, ICloneable, System.Data.IDbDataAdapter
type DbDataAdapter = class
    inherit DataAdapter
    interface IDbDataAdapter
    interface ICloneable
    interface IDataAdapter
Public MustInherit Class DbDataAdapter
Inherits DataAdapter
Implements ICloneable, IDbDataAdapter
Héritage
Dérivé
Implémente

Remarques

La DbDataAdapter classe hérite de la DataAdapter classe et implémente l' IDbDataAdapter interface.The DbDataAdapter class inherits from the DataAdapter class and implements the IDbDataAdapter interface. Il permet à une classe d’implémenter un DataAdapter conçu pour une utilisation avec une base de données relationnelle.It helps a class implement a DataAdapter designed for use with a relational database.

Une application ne crée pas directement une instance de DbDataAdapter la classe, mais crée une instance d’une classe qui hérite de celle-ci.An application does not create an instance of the DbDataAdapter class directly, but creates an instance of a class that inherits from it.

Les classes qui DbDataAdapter 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 DbDataAdapter must implement the inherited members, and typically define additional members to add provider-specific functionality. Par exemple, la DbDataAdapter classe définit la SelectCommand propriété, et la DbDataAdapter classe définit huit surcharges de la Fill méthode.For example, the DbDataAdapter class defines the SelectCommand property, and the DbDataAdapter class defines eight overloads of the Fill method. À son tour, OleDbDataAdapter la classe hérite Fill de la méthode et définit également deux surcharges supplémentaires Fill de 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 Fill that take an ADO Recordset object as a parameter.

Notes pour les responsables de l’implémentation

Lorsque vous héritez de DbDataAdapter la classe, nous vous recommandons d’implémenter les constructeurs suivants :When you inherit from the DbDataAdapter class, we recommend that you implement the following constructors:

ÉlémentItem DescriptionDescription
*Prv*DataAdapter()*Prv*DataAdapter() Initialise une nouvelle instance de la classe *PRV*DataAdapter.Initializes a new instance of the *Prv*DataAdapter class.
*PRV* DataAdapter (*PRV*, commande *SelectCommand*)*Prv*DataAdapter(*Prv*Command *selectCommand*) Initialise une nouvelle instance de la classe *PRV*DataAdapter avec l’instruction SQL SELECT spécifiée.Initializes a new instance of the *Prv*DataAdapter class with the specified SQL SELECT statement.
*Prv*DataAdapter(string *selectCommandText*, string *selectConnectionString*)*Prv*DataAdapter(string *selectCommandText*, string *selectConnectionString*) Initialise une nouvelle instance de la classe *PRV*DataAdapter avec une instruction SQL SELECT et une chaîne de connexion.Initializes a new instance of the *Prv*DataAdapter class with an SQL SELECT statement and a connection string.
*PRV* DataAdapter (String *selectCommandText*, *PRV*Connection *selectConnection*)*Prv*DataAdapter(string *selectCommandText*, *Prv*Connection *selectConnection*) Initialise une nouvelle instance de la classe *PRV*DataAdapter avec une instruction SQL SELECT et un objet *PRV*Connection.Initializes a new instance of the *Prv*DataAdapter class with an SQL SELECT statement and a *Prv*Connection object.

Pour promouvoir la cohérence entre les fournisseurs de données .NET Framework, vous devez nommer la classe qui hérite sous la forme PRVDataAdapter, 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, you should name the inheriting class in the form PrvDataAdapter, 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 l’espace de noms System. Data. SqlClient .For example, "Sql" is the prefix of the SqlDataAdapter class in the System.Data.SqlClient namespace.

Constructeurs

DbDataAdapter()

Initialise une nouvelle instance d’une classe DataAdapter.Initializes a new instance of a DataAdapter class.

DbDataAdapter(DbDataAdapter)

Initialise une nouvelle instance d'une classe DataAdapter à partir d'un objet existant du même type.Initializes a new instance of a DataAdapter class from an existing object of the same type.

Champs

DefaultSourceTableName

Nom par défaut utilisé par l'objet DataAdapter pour les mappages de table.The default name used by the DataAdapter object for table mappings.

Propriétés

AcceptChangesDuringFill

Obtient ou définit une valeur indiquant si AcceptChanges() est appelé sur un DataRow après son ajout à DataTable au cours de l’une des opérations Fill.Gets or sets a value indicating whether AcceptChanges() is called on a DataRow after it is added to the DataTable during any of the Fill operations.

(Hérité de DataAdapter)
AcceptChangesDuringUpdate

Obtient ou définit si AcceptChanges() est appelé pendant un Update(DataSet).Gets or sets whether AcceptChanges() is called during a Update(DataSet).

(Hérité de DataAdapter)
CanRaiseEvents

Obtient une valeur qui indique si le composant peut déclencher un événement.Gets a value indicating whether the component can raise an event.

(Hérité de Component)
Container

Obtient le IContainer qui contient Component.Gets the IContainer that contains the Component.

(Hérité de Component)
ContinueUpdateOnError

Obtient ou définit une valeur qui spécifie si une exception doit être générée en cas d'erreur pendant la mise à jour d'une ligne.Gets or sets a value that specifies whether to generate an exception when an error is encountered during a row update.

(Hérité de DataAdapter)
DeleteCommand

Obtient ou définit une commande permettant de supprimer les enregistrements du groupe de données.Gets or sets a command for deleting records from the data set.

DesignMode

Obtient une valeur qui indique si Component est actuellement en mode design.Gets a value that indicates whether the Component is currently in design mode.

(Hérité de Component)
Events

Obtient la liste des gestionnaires d'événements attachés à ce Component.Gets the list of event handlers that are attached to this Component.

(Hérité de Component)
FillCommandBehavior

Obtient ou définit le comportement de la commande utilisée pour remplir l'adaptateur de données.Gets or sets the behavior of the command used to fill the data adapter.

FillLoadOption

Obtient ou définit LoadOption qui détermine comment l'adaptateur remplit DataTable du DbDataReader.Gets or sets the LoadOption that determines how the adapter fills the DataTable from the DbDataReader.

(Hérité de DataAdapter)
InsertCommand

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

MissingMappingAction

Détermine l'action à effectuer si les données entrantes ne possèdent pas de table ou de colonne correspondante.Determines the action to take when incoming data does not have a matching table or column.

(Hérité de DataAdapter)
MissingSchemaAction

Détermine l'action à effectuer si le schéma DataSet existant ne correspond pas aux données entrantes.Determines the action to take when existing DataSet schema does not match incoming data.

(Hérité de DataAdapter)
ReturnProviderSpecificTypes

Obtient ou définit si la méthode Fill doit retourner des valeurs spécifiques au fournisseur ou des valeurs communes conformes CLS.Gets or sets whether the Fill method should return provider-specific values or common CLS-compliant values.

(Hérité de DataAdapter)
SelectCommand

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

Site

Obtient ou définit le ISite de Component.Gets or sets the ISite of the Component.

(Hérité de Component)
TableMappings

Obtient une collection qui fournit le mappage principal entre une table source et DataTable.Gets a collection that provides the master mapping between a source table and a DataTable.

(Hérité de DataAdapter)
UpdateBatchSize

Obtient ou définit une valeur qui active ou désactive la prise en charge du traitement par lots et qui spécifie le nombre de commandes pouvant être exécutées dans un lot.Gets or sets a value that enables or disables batch processing support, and specifies the number of commands that can be executed in a batch.

UpdateCommand

Obtient ou définit une commande utilisée pour mettre à jour des enregistrements dans la source de données.Gets or sets a command used to update records in the data source.

Méthodes

AddToBatch(IDbCommand)

Ajoute IDbCommand au lot actuel.Adds a IDbCommand to the current batch.

ClearBatch()

Supprime tous les objets IDbCommand du lot.Removes all IDbCommand objects from the batch.

CloneInternals()

Crée une copie de cette instance de DataAdapter.Creates a copy of this instance of DataAdapter.

(Hérité de DataAdapter)
CreateObjRef(Type)

Crée un objet contenant toutes les informations appropriées requises pour générer un proxy permettant de communiquer avec un objet distant.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Hérité de MarshalByRefObject)
CreateRowUpdatedEvent(DataRow, IDbCommand, StatementType, DataTableMapping)

Initialise une nouvelle instance de la classe RowUpdatedEventArgs.Initializes a new instance of the RowUpdatedEventArgs class.

CreateRowUpdatingEvent(DataRow, IDbCommand, StatementType, DataTableMapping)

Initialise une nouvelle instance de la classe RowUpdatingEventArgs.Initializes a new instance of the RowUpdatingEventArgs class.

CreateTableMappings()

Crée un DataTableMappingCollection.Creates a new DataTableMappingCollection.

(Hérité de DataAdapter)
Dispose()

Libère toutes les ressources utilisées par Component.Releases all resources used by the Component.

(Hérité de Component)
Dispose(Boolean)

Libère les ressources non managées utilisées par DbDataAdapter et libère éventuellement les ressources managées.Releases the unmanaged resources used by the DbDataAdapter and optionally releases the managed resources.

Equals(Object)

Détermine si l'objet spécifié est égal à l'objet actuel.Determines whether the specified object is equal to the current object.

(Hérité de Object)
ExecuteBatch()

Exécute le lot actuel.Executes the current batch.

Fill(DataSet)

Ajoute ou actualise des lignes dans le DataSet.Adds or refreshes rows in the DataSet.

Fill(DataSet, Int32, Int32, String)

Ajoute ou actualise des lignes dans une plage spécifiée de DataSet pour qu'elles correspondent à celles de la source de données en utilisant les noms DataSet et DataTable.Adds or refreshes rows in a specified range in the DataSet to match those in the data source using the DataSet and DataTable names.

Fill(DataSet, Int32, Int32, String, IDbCommand, CommandBehavior)

Ajoute ou actualise des lignes dans une plage spécifiée de DataSet pour qu'elles correspondent à celles de la source de données en utilisant DataSet et les noms de tables source, la chaîne de commande et le comportement des commandes.Adds or refreshes rows in a specified range in the DataSet to match those in the data source using the DataSet and source table names, command string, and command behavior.

Fill(DataSet, String)

Ajoute ou actualise les lignes de DataSet pour qu'elles correspondent à celles de la source de données en utilisant les noms DataSet et DataTable.Adds or refreshes rows in the DataSet to match those in the data source using the DataSet and DataTable names.

Fill(DataSet, String, IDataReader, Int32, Int32)

Ajoute ou actualise des lignes dans une plage spécifiée de DataSet pour les faire correspondre à celles de la source de données en utilisant les noms DataSet, DataTable et IDataReader.Adds or refreshes rows in a specified range in the DataSet to match those in the data source using the DataSet, DataTable, and IDataReader names.

Fill(DataTable)

Ajoute ou actualise des lignes dans une plage spécifiée de DataSet pour qu'elles correspondent à celles de la source de données, en utilisant le nom DataTable.Adds or refreshes rows in a specified range in the DataSet to match those in the data source using the DataTable name.

Fill(DataTable, IDataReader)

Ajoute ou actualise les lignes d’un DataTable pour les faire correspondre dans la source de données en utilisant les noms DataTable et IDataReader spécifiés.Adds or refreshes rows in a DataTable to match those in the data source using the specified DataTable and IDataReader names.

Fill(DataTable, IDbCommand, CommandBehavior)

Ajoute ou actualise les lignes de DataTable pour établir une correspondance avec celles de la source de données à l'aide des DataTable, IDbCommand et CommandBehavior spécifiés.Adds or refreshes rows in a DataTable to match those in the data source using the specified DataTable, IDbCommand and CommandBehavior.

Fill(DataTable[], IDataReader, Int32, Int32)

Ajoute ou actualise des lignes d'une plage spécifiée de la collection d'objets DataTable pour qu'elles correspondent à celles de la source de données.Adds or refreshes rows in a specified range in the collection of DataTable objects to match those in the data source.

(Hérité de DataAdapter)
Fill(DataTable[], Int32, Int32, IDbCommand, CommandBehavior)

Ajoute ou actualise des lignes dans une plage spécifiée de DataSet pour qu'elles correspondent à celles de la source de données en utilisant les noms DataSet et DataTable.Adds or refreshes rows in a specified range in the DataSet to match those in the data source using the DataSet and DataTable names.

Fill(Int32, Int32, DataTable[])

Ajoute ou actualise des lignes dans un DataTable pour établir une correspondance avec celles de la source de données en commençant à l'enregistrement spécifié et en récupérant le nombre maximal d'enregistrements spécifié.Adds or refreshes rows in a DataTable to match those in the data source starting at the specified record and retrieving up to the specified maximum number of records.

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

FillSchema(DataSet, SchemaType, IDbCommand, String, CommandBehavior)

Ajoute un DataTable 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 défini.Adds a DataTable to the specified DataSet and configures the schema to match that in the data source based on the specified SchemaType.

FillSchema(DataSet, SchemaType, String)

Ajoute un DataTable au DataSet spécifié et configure le schéma pour qu'il corresponde à celui de la source de données en se basant sur les SchemaType et DataTable définis.Adds a DataTable to the specified DataSet and configures the schema to match that in the data source based upon the specified SchemaType and DataTable.

FillSchema(DataSet, SchemaType, String, IDataReader)

Ajoute DataTable au DataSet spécifié.Adds a DataTable to the specified DataSet.

(Hérité de DataAdapter)
FillSchema(DataTable, SchemaType)

Configure le schéma du DataTable spécifié en fonction du SchemaType défini.Configures the schema of the specified DataTable based on the specified SchemaType.

FillSchema(DataTable, SchemaType, IDataReader)

Ajoute DataTable au DataSet spécifié.Adds a DataTable to the specified DataSet.

(Hérité de DataAdapter)
FillSchema(DataTable, SchemaType, IDbCommand, CommandBehavior)

Configure le schéma du DataTable spécifié en fonction du SchemaType, de la chaîne de commande et des valeurs CommandBehavior définis.Configures the schema of the specified DataTable based on the specified SchemaType, command string, and CommandBehavior values.

GetBatchedParameter(Int32, Int32)

Retourne IDataParameter à partir de l'une des commandes du lot actuel.Returns a IDataParameter from one of the commands in the current batch.

GetBatchedRecordsAffected(Int32, Int32, Exception)

Retourne les informations relatives à une tentative de mise à jour distincte dans le cadre plus large d'une mise à jour groupée.Returns information about an individual update attempt within a larger batched update.

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.

GetHashCode()

Sert de fonction de hachage par défaut.Serves as the default hash function.

(Hérité de Object)
GetLifetimeService()

Récupère l'objet de service de durée de vie en cours qui contrôle la stratégie de durée de vie de cette instance.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Hérité de MarshalByRefObject)
GetService(Type)

Retourne un objet qui représente un service fourni par Component ou par son Container.Returns an object that represents a service provided by the Component or by its Container.

(Hérité de Component)
GetType()

Obtient le Type de l'instance actuelle.Gets the Type of the current instance.

(Hérité de Object)
HasTableMappings()

Indique si DataTableMappingCollection a été créé.Indicates whether a DataTableMappingCollection has been created.

(Hérité de DataAdapter)
InitializeBatching()

Initialise le mode batch pour DbDataAdapter.Initializes batching for the DbDataAdapter.

InitializeLifetimeService()

Obtient un objet de service de durée de vie pour contrôler la stratégie de durée de vie de cette instance.Obtains a lifetime service object to control the lifetime policy for this instance.

(Hérité de MarshalByRefObject)
MemberwiseClone()

Crée une copie superficielle du Object actuel.Creates a shallow copy of the current Object.

(Hérité de Object)
MemberwiseClone(Boolean)

Crée une copie superficielle de l'objet MarshalByRefObject actuel.Creates a shallow copy of the current MarshalByRefObject object.

(Hérité de MarshalByRefObject)
OnFillError(FillErrorEventArgs)

Déclenche l'événement FillError.Raises the FillError event.

OnRowUpdated(RowUpdatedEventArgs)

Déclenche l'événement RowUpdated d'un fournisseur de données .NET Framework.Raises the RowUpdated event of a .NET Framework data provider.

OnRowUpdating(RowUpdatingEventArgs)

Déclenche l'événement RowUpdating d'un fournisseur de données .NET Framework.Raises the RowUpdating event of a .NET Framework data provider.

ResetFillLoadOption()

Réinitialise FillLoadOption à son état par défaut et entraîne une réponse de Fill(DataSet) à AcceptChangesDuringFill.Resets FillLoadOption to its default state and causes Fill(DataSet) to honor AcceptChangesDuringFill.

(Hérité de DataAdapter)
ShouldSerializeAcceptChangesDuringFill()

Détermine si la propriété AcceptChangesDuringFill doit être persistante.Determines whether the AcceptChangesDuringFill property should be persisted.

(Hérité de DataAdapter)
ShouldSerializeFillLoadOption()

Détermine si la propriété FillLoadOption doit être persistante.Determines whether the FillLoadOption property should be persisted.

(Hérité de DataAdapter)
ShouldSerializeTableMappings()

Détermine si un ou plusieurs objets DataTableMapping existent et s'ils doivent être persistants.Determines whether one or more DataTableMapping objects exist and they should be persisted.

(Hérité de DataAdapter)
TerminateBatching()

Termine le mode batch pour DbDataAdapter.Ends batching for the DbDataAdapter.

ToString()

Retourne un String contenant le nom du Component, s’il en existe un.Returns a String containing the name of the Component, if any. Cette méthode ne doit pas être remplacée.This method should not be overridden.

(Hérité de Component)
Update(DataRow[])

Met à jour les valeurs de la base de données en exécutant les instructions INSERT, UPDATE ou DELETE respectives pour chaque ligne insérée, mise à jour ou supprimée dans DataSet.Updates the values in the database by executing the respective INSERT, UPDATE, or DELETE statements for each inserted, updated, or deleted row in the specified array in the DataSet.

Update(DataRow[], DataTableMapping)

Met à jour les valeurs de la base de données en exécutant les instructions INSERT, UPDATE ou DELETE respectives pour chaque ligne insérée, mise à jour ou supprimée dans le tableau d'objets DataSet spécifié.Updates the values in the database by executing the respective INSERT, UPDATE, or DELETE statements for each inserted, updated, or deleted row in the specified array of DataSet objects.

Update(DataSet)

Met à jour les valeurs de la base de données en exécutant les instructions INSERT, UPDATE ou DELETE respectives pour chaque ligne insérée, mise à jour ou supprimée dans le DataSet spécifié.Updates the values in the database by executing the respective INSERT, UPDATE, or DELETE statements for each inserted, updated, or deleted row in the specified DataSet.

Update(DataSet, String)

Met à jour les valeurs de la base de données en exécutant les instructions INSERT, UPDATE ou DELETE respectives pour chaque ligne insérée, mise à jour ou supprimée dans DataSet avec le nom DataTable spécifié.Updates the values in the database by executing the respective INSERT, UPDATE, or DELETE statements for each inserted, updated, or deleted row in the DataSet with the specified DataTable name.

Update(DataTable)

Met à jour les valeurs de la base de données en exécutant les instructions INSERT, UPDATE ou DELETE respectives pour chaque ligne insérée, mise à jour ou supprimée dans le DataTable spécifié.Updates the values in the database by executing the respective INSERT, UPDATE, or DELETE statements for each inserted, updated, or deleted row in the specified DataTable.

Événements

Disposed

Se produit lorsque le composant est supprimé par un appel à la méthode Dispose().Occurs when the component is disposed by a call to the Dispose() method.

(Hérité de Component)
FillError

Retourné lorsqu'une erreur se produit pendant une opération de remplissage.Returned when an error occurs during a fill operation.

Implémentations d’interfaces explicites

ICloneable.Clone()

Crée un objet qui est une copie de l'instance actuelle.Creates a new object that is a copy of the current instance.

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

(Hérité de DataAdapter)
IDbDataAdapter.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.

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

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

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

S’applique à

Voir aussi