DbDataAdapter Classe

Définition

Aide l'implémentation de l'interface IDbDataAdapter. 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 de DataAdapter.

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

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

Pour promouvoir la cohérence entre .NET Framework fournisseurs de données, 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

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

DefaultSourceTableName

Nom par défaut utilisé par l'objet DataAdapter pour les mappages de table.

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.

(Hérité de DataAdapter)
AcceptChangesDuringUpdate

Obtient ou définit si AcceptChanges() est appelé pendant un Update(DataSet).

(Hérité de DataAdapter)
CanRaiseEvents

Obtient une valeur qui indique si le composant peut déclencher un événement.

(Hérité de Component)
Container

Obtient le IContainer qui contient la 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.

(Hérité de DataAdapter)
DeleteCommand

Obtient ou définit une commande permettant de supprimer les enregistrements du groupe de données.

DesignMode

Obtient une valeur qui indique si Component est actuellement en mode design.

(Hérité de Component)
Events

Obtient la liste des gestionnaires d'événements 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 LoadOption qui détermine comment l'adaptateur remplit DataTable 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 à effectuer si les données entrantes ne possèdent pas de table ou de colonne correspondante.

(Hérité de DataAdapter)
MissingSchemaAction

Détermine l'action à effectuer si le schéma DataSet existant ne correspond pas aux données entrantes.

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

(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 ISite de Component.

(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 qui spécifie le nombre de commandes pouvant être exécutées dans un lot.

UpdateCommand

Obtient ou définit une commande utilisée pour mettre à jour des enregistrements dans la source de données.

Méthodes

AddToBatch(IDbCommand)

Ajoute IDbCommand au lot actuel.

ClearBatch()

Supprime tous les objets IDbCommand du lot.

CloneInternals()
Obsolète.
Obsolète.
Obsolète.
Obsolète.

Crée une copie de cette instance de 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.

(Hérité de MarshalByRefObject)
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 DataTableMappingCollection.

(Hérité de DataAdapter)
Dispose()

Libère toutes les ressources utilisées par 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.

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)

Ajoute ou actualise des lignes dans le 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.

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.

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.

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.

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

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.

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

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.

Fill(DataTable, IDataReader)

Ajoute ou actualise les lignes de DataTable pour établir une correspondance avec celles de la source de données à l'aide du nom DataTable et du IDataReader spécifié.

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

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.

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

Fill(Int32, Int32, DataTable[])

Ajoute ou actualise des lignes dans un ou plusieurs DataTable objets pour qu’ils correspondent à ceux de la source de données en commençant à l’enregistrement spécifié et en récupérant jusqu’au nombre maximal spécifié d’enregistrements.

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

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.

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.

FillSchema(DataSet, SchemaType, String, IDataReader)

Ajoute DataTable au DataSet spécifié.

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

Configure le schéma du DataTable spécifié en fonction du SchemaType défini.

FillSchema(DataTable, SchemaType, IDataReader)

Ajoute DataTable au DataSet spécifié.

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

GetBatchedParameter(Int32, Int32)

Retourne IDataParameter à partir de l'une des commandes du lot actuel.

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.

GetFillParameters()

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

GetHashCode()

Fait office 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 en cours 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 Component ou par son Container.

(Hérité de Component)
GetType()

Obtient le Type de l'instance actuelle.

(Hérité de Object)
HasTableMappings()

Indique si DataTableMappingCollection a été créé.

(Hérité de DataAdapter)
InitializeBatching()

Initialise le mode batch pour 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 Object actuel.

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

Crée une copie superficielle de l'objet MarshalByRefObject actuel.

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

Déclenche l’événement FillError.

OnFillError(FillErrorEventArgs)

Appelé lorsqu'une erreur se produit pendant 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 entraîne une réponse de Fill(DataSet) à AcceptChangesDuringFill.

(Hérité de DataAdapter)
ShouldSerializeAcceptChangesDuringFill()

Détermine si la propriété AcceptChangesDuringFill doit être persistante.

(Hérité de DataAdapter)
ShouldSerializeFillLoadOption()

Détermine si la propriété FillLoadOption doit être persistante.

(Hérité de DataAdapter)
ShouldSerializeTableMappings()

Détermine si un ou plusieurs objets DataTableMapping existent et s'ils doivent être persistants.

(Hérité de DataAdapter)
TerminateBatching()

Termine le mode batch pour DbDataAdapter.

ToString()

Retourne un String contenant le nom du Component, s’il en existe un. Cette méthode ne doit pas être remplacée.

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

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

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

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

Événements

Disposed

Se produit lorsque le composant est supprimé par un appel à la méthode Dispose().

(Hérité de Component)
FillError

Retourné lorsqu'une erreur se produit pendant une opération de remplissage.

FillError

Retourné lorsqu'une erreur se produit pendant une opération de remplissage.

(Hérité de DataAdapter)

Implémentations d’interfaces explicites

ICloneable.Clone()
Obsolète.

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

(Hérité de DataAdapter)
IDbDataAdapter.DeleteCommand

Obtient ou définit une instruction SQL permettant de supprimer les enregistrements du groupe 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.

S’applique à

Voir aussi