DataAdapter Classe
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Représente un ensemble de commandes SQL et une connexion de base de données utilisée pour remplir et DataSet mettre à jour la source de données.
public ref class DataAdapter abstract : System::ComponentModel::Component, System::Data::IDataAdapterpublic ref class DataAdapter : System::ComponentModel::Component, System::Data::IDataAdapterpublic abstract class DataAdapter : System.ComponentModel.Component, System.Data.IDataAdapterpublic class DataAdapter : System.ComponentModel.Component, System.Data.IDataAdaptertype DataAdapter = class
inherit Component
interface IDataAdapterPublic MustInherit Class DataAdapter
Inherits Component
Implements IDataAdapterPublic Class DataAdapter
Inherits Component
Implements IDataAdapter- Héritage
- Dérivé
- Implémente
Remarques
Sert DataAdapter de pont entre une source de données et une DataSet source de données pour récupérer et enregistrer des données. Le DataAdapter pont fournit ce pont en mappant Fill, qui modifie les données dans le DataSet pour qu’elles correspondent aux données de la source de données et Update, qui modifie les données de la source de données pour qu’elles correspondent aux données de la DataSetsource de données .
Si vous vous connectez à une base de données SQL Server, vous pouvez augmenter les performances globales en utilisant le SqlDataAdapter ainsi que ses objets SqlCommand et SqlConnection associés. Pour les sources de données prises en charge par OLE DB, utilisez-les DataAdapter avec ses objets et OleDbConnection ses objets associésOleDbCommand. Pour les sources de données prises en charge par ODBC, utilisez-les DataAdapter avec ses objets et OdbcConnection ses objets associésOdbcCommand. Pour les bases de données Oracle, utilisez-les DataAdapter avec ses objets et OracleConnection ses objets associésOracleCommand.
Lorsqu’une instance est DataAdapter créée, les propriétés en lecture/écriture sont définies sur les valeurs initiales. Pour obtenir la liste de ces valeurs, consultez le DataAdapter constructeur.
Constructeurs
| Nom | Description |
|---|---|
| DataAdapter() |
Initialise une nouvelle instance de la classe DataAdapter. |
| DataAdapter(DataAdapter) |
Initialise une nouvelle instance de la DataAdapter classe à partir d’un objet existant du même type. |
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 . |
| AcceptChangesDuringUpdate |
Obtient ou définit si AcceptChanges() elle est appelée pendant un Update(DataSet). |
| 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. |
| 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) |
| 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. |
| MissingMappingAction |
Détermine l’action à entreprendre lorsque les données entrantes n’ont pas de table ou de colonne correspondante. |
| MissingSchemaAction |
Détermine l’action à entreprendre lorsque le schéma existant DataSet ne correspond pas aux données entrantes. |
| ReturnProviderSpecificTypes |
Obtient ou définit si la |
| 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. |
Méthodes
| Nom | Description |
|---|---|
| CloneInternals() |
Obsolète.
Obsolète.
Obsolète.
Crée une copie de cette instance de DataAdapter. |
| CreateObjRef(Type) |
Crée un objet qui contient toutes les informations pertinentes requises pour générer un proxy utilisé pour communiquer avec un objet distant. (Hérité de MarshalByRefObject) |
| CreateTableMappings() |
Crée un nouveau DataTableMappingCollection. |
| 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 DataAdapter 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) |
| 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 DataSet des DataTable noms. |
| Fill(DataSet) |
Ajoute ou actualise des lignes dans la DataSet source de données pour les mettre en correspondance. |
| 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. |
| 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. |
| FillSchema(DataSet, SchemaType, String, IDataReader) | |
| FillSchema(DataSet, SchemaType) |
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(DataTable, SchemaType, IDataReader) | |
| 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() |
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éé. |
| 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. (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 |
| ResetFillLoadOption() |
Réinitialise FillLoadOption son état par défaut et provoque Fill(DataSet) l’honneur AcceptChangesDuringFill. |
| ShouldSerializeAcceptChangesDuringFill() |
Détermine si la AcceptChangesDuringFill propriété doit être conservée. |
| ShouldSerializeFillLoadOption() |
Détermine si la FillLoadOption propriété doit être conservée. |
| ShouldSerializeTableMappings() |
Détermine si un ou plusieurs DataTableMapping objets existent et qu’ils doivent être conservés. |
| 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(DataSet) |
Appelle 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 à partir d’une DataTable table nommée. |
É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. |
Implémentations d’interfaces explicites
| Nom | Description |
|---|---|
| IDataAdapter.TableMappings |
Obtient une collection qui indique comment une table source est mappée à une table de jeu de données. |