DbDataAdapter Classe

Définition

Espace de noms:

System.Data.Common

Assemblys:

netstandard.dll, System.Data.Common.dll

Source:

DbDataAdapter.cs

Mise en œuvre des aides de l’interface IDbDataAdapter . Les héritiers d’implémentation DbDataAdapter d’un ensemble de fonctions pour fournir une saisie forte, mais héritent de la plupart des fonctionnalités nécessaires pour implémenter entièrement un 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 IDataAdapter
    interface IDbDataAdapter
    interface ICloneable

Public MustInherit Class DbDataAdapter
Inherits DataAdapter
Implements ICloneable, IDbDataAdapter

Héritage

Object

MarshalByRefObject

Component

DataAdapter

DbDataAdapter

Dérivé

System.Data.Odbc.OdbcDataAdapter

System.Data.OleDb.OleDbDataAdapter

System.Data.OracleClient.OracleDataAdapter

System.Data.SqlClient.SqlDataAdapter

Implémente

IDataAdapter IDbDataAdapter ICloneable

Remarques

La DbDataAdapter classe hérite de la DataAdapter classe et implémente l’interface IDbDataAdapter . Il permet à une classe d’implémenter un DataAdapter conçu pour une utilisation avec une base de données relationnelle.

Une application ne crée pas directement une instance de la DbDataAdapter classe, mais crée une instance d’une classe qui hérite de celle-ci.

Les classes qui héritent DbDataAdapter 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, la DbDataAdapter classe définit la SelectCommand propriété et la DbDataAdapter classe définit huit surcharges de la Fill méthode. À son tour, la OleDbDataAdapter classe hérite de la Fill méthode et définit également deux surcharges supplémentaires de Fill ce qui prend un objet Recordset ADO en tant que paramètre.

Notes pour les responsables de l’implémentation

Lorsque vous héritez de la DbDataAdapter classe, nous vous recommandons d’implémenter les constructeurs suivants :

Élément	Description
*Prv*DataAdapter()	Initialise une nouvelle instance de la classe *Prv*DataAdapter.
*Prv*DataAdapter(*Prv*Command *selectCommand*)	Initialise une nouvelle instance de la classe *Prv*DataAdapter avec l’instruction SQL SELECT spécifiée.
*Prv*DataAdapter(string *selectCommandText*, chaîne *selectConnectionString*)	Initialise une nouvelle instance de la classe *Prv*DataAdapter avec une instruction SQL SELECT et une chaîne de connexion.
*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.

Pour promouvoir la cohérence entre les fournisseurs de données .NET Framework, vous devez nommer la classe héritée sous la forme PrvDataAdapter, 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 de noms System.Data.SqlClient .

Constructeurs

Nom	Description
DbDataAdapter()	Initialise une nouvelle instance d’une classe DataAdapter .
DbDataAdapter(DbDataAdapter)	Initialise une nouvelle instance de la DataAdapter classe à partir d’un objet existant du même type.

Champs

Nom	Description
DefaultSourceTableName	Nom par défaut utilisé par l’objet pour les DataAdapter mappages de tables.

Propriétés

Nom	Description
AcceptChangesDuringFill	Obtient ou définit une valeur indiquant si AcceptChanges() elle est appelée après DataRow son ajout à l’une DataTable des opérations de remplissage . (Hérité de DataAdapter)
AcceptChangesDuringUpdate	Obtient ou définit si AcceptChanges() elle est appelée pendant un Update(DataSet). (Hérité de DataAdapter)
CanRaiseEvents	Obtient une valeur indiquant si le composant peut déclencher un événement. (Hérité de Component)
Container	Obtient le IContainer fichier qui contient le Component. (Hérité de Component)
ContinueUpdateOnError	Obtient ou définit une valeur qui spécifie s’il faut générer une exception lorsqu’une erreur est rencontrée lors d’une mise à jour de ligne. (Hérité de DataAdapter)
DeleteCommand	Obtient ou définit une commande pour supprimer des enregistrements du jeu de données.
DesignMode	Obtient une valeur qui indique si la Component valeur est actuellement en mode création. (Hérité de Component)
Events	Obtient la liste des gestionnaires d’événements qui sont attachés à ce Component. (Hérité de Component)
FillCommandBehavior	Obtient ou définit le comportement de la commande utilisée pour remplir l’adaptateur de données.
FillLoadOption	Obtient ou définit l’élément LoadOption qui détermine la façon dont l’adaptateur remplit l’adaptateur DataTable à partir du 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.
MissingMappingAction	Détermine l’action à entreprendre lorsque les données entrantes n’ont pas de table ou de colonne correspondante. (Hérité de DataAdapter)
MissingSchemaAction	Détermine l’action à entreprendre lorsque le schéma existant DataSet ne correspond pas aux données entrantes. (Hérité de DataAdapter)
ReturnProviderSpecificTypes	Obtient ou définit si la Fill méthode doit retourner des valeurs spécifiques au fournisseur ou des valeurs compatibles CLS courantes. (Hérité de DataAdapter)
SelectCommand	Obtient ou définit une commande utilisée pour sélectionner des enregistrements dans la source de données.
Site	Obtient ou définit le ISiteComponent. (Hérité de Component)
TableMappings	Obtient une collection qui fournit le mappage principal entre une table source et un 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 spécifie le nombre de commandes qui peuvent être exécutées dans un lot.
UpdateCommand	Obtient ou définit une commande utilisée pour mettre à jour les enregistrements dans la source de données.

Méthodes

Nom	Description
AddToBatch(IDbCommand)	Ajoute un IDbCommand lot actuel.
ClearBatch()	Supprime tous les IDbCommand objets du lot.
CloneInternals()	Obsolète. Crée une copie de cette instance de DataAdapter. (Hérité de DataAdapter)
CreateRowUpdatedEvent(DataRow, IDbCommand, StatementType, DataTableMapping)	Initialise une nouvelle instance de la classe RowUpdatedEventArgs.
CreateRowUpdatingEvent(DataRow, IDbCommand, StatementType, DataTableMapping)	Initialise une nouvelle instance de la classe RowUpdatingEventArgs.
CreateTableMappings()	Crée un nouveau DataTableMappingCollection. (Hérité de DataAdapter)
Dispose()	Libère toutes les ressources utilisées par le Component. (Hérité de Component)
Dispose(Boolean)	Libère les ressources non managées utilisées par les DbDataAdapter ressources gérées et libère éventuellement les ressources managées.
Equals(Object)	Détermine si l’objet spécifié est égal à l’objet actuel. (Hérité de Object)
ExecuteBatch()	Exécute le lot actuel.
Fill(DataSet, Int32, Int32, String, IDbCommand, CommandBehavior)	Ajoute ou actualise les lignes d’une plage spécifiée dans la DataSet plage pour qu’elles correspondent à celles de la source de données à l’aide des DataSet noms de table source, de la chaîne de commande et du comportement des commandes.
Fill(DataSet, Int32, Int32, String)	Ajoute ou actualise des lignes dans une plage spécifiée dans la DataSet plage pour qu’elles correspondent à celles de la source de données à l’aide des noms et DataTable des DataSet noms.
Fill(DataSet, String, IDataReader, Int32, Int32)	Ajoute ou actualise des lignes dans une plage spécifiée dans la DataSet plage pour qu’elles correspondent à celles de la source de données à l’aide des noms et DataTable des DataSet noms. (Hérité de DataAdapter)
Fill(DataSet, String)	Ajoute ou actualise des lignes dans le DataSet pour qu’elles correspondent à celles de la source de données à l’aide des noms et DataTable des DataSet noms.
Fill(DataSet)	Ajoute ou actualise des lignes dans le DataSet.
Fill(DataTable, IDataReader)	Ajoute ou actualise des lignes dans le DataTable pour qu’elles correspondent à celles de la source de données à l’aide du DataTable nom et de l’élément spécifié IDataReader. (Hérité de DataAdapter)
Fill(DataTable, IDbCommand, CommandBehavior)	Ajoute ou actualise des lignes dans un DataTable pour qu’elles correspondent à celles de la source de données à l’aide des éléments spécifiés DataTableet IDbCommandCommandBehavior.
Fill(DataTable)	Ajoute ou actualise des lignes dans une plage spécifiée dans la DataSet plage pour qu’elles correspondent à celles de la source de données à l’aide du DataTable nom.
Fill(DataTable[], IDataReader, Int32, Int32)	Ajoute ou actualise des lignes dans une plage spécifiée dans la collection d’objets pour les mettre en correspondance dans la source de DataTable données. (Hérité de DataAdapter)
Fill(DataTable[], Int32, Int32, IDbCommand, CommandBehavior)	Ajoute ou actualise des lignes dans une plage spécifiée dans la DataSet plage pour qu’elles correspondent à celles de la source de données à l’aide des noms et DataTable des DataSet noms.
Fill(Int32, Int32, DataTable[])	Ajoute ou actualise des lignes dans un ou plusieurs DataTable objets pour les mettre en correspondance dans la source de données à partir de l’enregistrement spécifié et récupérer jusqu’au nombre maximal spécifié d’enregistrements.
FillSchema(DataSet, SchemaType, IDbCommand, String, CommandBehavior)	Ajoute un DataTable au schéma spécifié DataSet et configure le schéma pour qu’il corresponde à celui dans la source de données en fonction de l’élément spécifié SchemaType.
FillSchema(DataSet, SchemaType, String, IDataReader)	Ajoute un DataTable à l’objet spécifié DataSet. (Hérité de DataAdapter)
FillSchema(DataSet, SchemaType, String)	Ajoute un DataTable au schéma spécifié DataSet et configure le schéma pour qu’il corresponde à celui dans la source de données en fonction de l’élément spécifié SchemaType et DataTable.
FillSchema(DataSet, SchemaType)	Ajoute une DataTable « table » nommée au schéma spécifié DataSet et configure le schéma pour qu’il corresponde à celui dans la source de données en fonction de l’élément spécifié SchemaType.
FillSchema(DataTable, SchemaType, IDataReader)	Ajoute un DataTable à l’objet spécifié DataSet. (Hérité de DataAdapter)
FillSchema(DataTable, SchemaType, IDbCommand, CommandBehavior)	Configure le schéma de l’objet DataTable spécifié en fonction de la chaîne de commande et CommandBehavior des valeurs spécifiéesSchemaType.
FillSchema(DataTable, SchemaType)	Configure le schéma de l’objet spécifié DataTable en fonction de l’objet spécifié SchemaType.
GetBatchedParameter(Int32, Int32)	Retourne une IDataParameter commande de l’une des commandes du lot actuel.
GetBatchedRecordsAffected(Int32, Int32, Exception)	Retourne des informations sur une tentative de mise à jour individuelle au sein d’une mise à jour par lots plus grande.
GetFillParameters()	Obtient les paramètres définis par l’utilisateur lors de l’exécution d’une instruction SQL SELECT.
GetHashCode()	Sert de fonction de hachage par défaut. (Hérité de Object)
GetLifetimeService()	Obsolète. Récupère l’objet de service de durée de vie actuel qui contrôle la stratégie de durée de vie de cette instance. (Hérité de MarshalByRefObject)
GetService(Type)	Retourne un objet qui représente un service fourni par le Component ou par son Container. (Hérité de Component)
GetType()	Obtient la Type de l’instance actuelle. (Hérité de Object)
HasTableMappings()	Indique si un DataTableMappingCollection a été créé. (Hérité de DataAdapter)
InitializeBatching()	Initialise le traitement par lots pour le DbDataAdapter.
InitializeLifetimeService()	Obsolète. Obtient un objet de service de durée de vie pour contrôler la stratégie de durée de vie de cette instance. (Hérité de MarshalByRefObject)
MemberwiseClone()	Crée une copie superficielle du Objectactuel. (Hérité de Object)
MemberwiseClone(Boolean)	Crée une copie superficielle de l’objet actuel MarshalByRefObject . (Hérité de MarshalByRefObject)
OnFillError(FillErrorEventArgs)	Appelé lorsqu’une erreur se produit pendant un Fill. (Hérité de DataAdapter)
OnRowUpdated(RowUpdatedEventArgs)	Déclenche l’événement RowUpdated d’un fournisseur de données .NET.
OnRowUpdating(RowUpdatingEventArgs)	Déclenche l’événement RowUpdating d’un fournisseur de données .NET.
ResetFillLoadOption()	Réinitialise FillLoadOption son état par défaut et provoque Fill(DataSet) l’honneur AcceptChangesDuringFill. (Hérité de DataAdapter)
ShouldSerializeAcceptChangesDuringFill()	Détermine si la AcceptChangesDuringFill propriété doit être conservée. (Hérité de DataAdapter)
ShouldSerializeFillLoadOption()	Détermine si la FillLoadOption propriété doit être conservée. (Hérité de DataAdapter)
ShouldSerializeTableMappings()	Détermine si un ou plusieurs DataTableMapping objets existent et qu’ils doivent être conservés. (Hérité de DataAdapter)
TerminateBatching()	Termine le traitement par lot pour le DbDataAdapter.
ToString()	Retourne un String nom contenant le nom du Component, le cas échéant. Cette méthode ne doit pas être remplacée. (Hérité de Component)
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 DataRow spécifié.
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 le tableau spécifié dans le 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 le DataSet nom spécifié DataTable .
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 la ligne spécifiée DataSet.
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 la ligne spécifiée DataTable.

Événements

Nom	Description
Disposed	Se produit lorsque le composant est supprimé par un appel à la Dispose() méthode. (Hérité de Component)
FillError	Retourné lorsqu’une erreur se produit pendant une opération de remplissage. (Hérité de DataAdapter)

Implémentations d’interfaces explicites

Nom	Description
ICloneable.Clone()	Crée un objet qui est une copie de l’instance actuelle.
IDataAdapter.TableMappings	Obtient une collection qui indique comment une table source est mappée à une table de jeu de données. (Hérité de DataAdapter)
IDbDataAdapter.DeleteCommand	Obtient ou définit une instruction SQL pour supprimer des enregistrements du jeu de données.
IDbDataAdapter.InsertCommand	Obtient ou définit une instruction SQL utilisée pour insérer de nouveaux enregistrements dans la source de données.
IDbDataAdapter.SelectCommand	Obtient ou définit une instruction SQL utilisée pour sélectionner des enregistrements dans la source de données.
IDbDataAdapter.UpdateCommand	Obtient ou définit une instruction SQL utilisée pour mettre à jour les enregistrements dans la source de données.

Voir aussi

• DbProviderFactories (ADO.NET)
• Vue d'ensemble d’ADO.NET