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 qui sont utilisées pour remplir DataSet et mettre à jour la source de données.
public ref class DataAdapter : System::ComponentModel::Component, System::Data::IDataAdapterpublic ref class DataAdapter abstract : System::ComponentModel::Component, System::Data::IDataAdapterpublic class DataAdapter : System.ComponentModel.Component, System.Data.IDataAdapterpublic abstract class DataAdapter : System.ComponentModel.Component, System.Data.IDataAdaptertype DataAdapter = class
inherit Component
interface IDataAdapterPublic Class DataAdapter
Inherits Component
Implements IDataAdapterPublic MustInherit Class DataAdapter
Inherits Component
Implements IDataAdapter- Héritage
- Dérivé
- Implémente
Remarques
Sert DataAdapter de pont entre une DataSet source de données et une source de données pour récupérer et enregistrer des données. Fournit DataAdapter 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 dans la source de données pour qu’elles correspondent aux données dans le DataSet.
Si vous vous connectez à une base de données SQL Server, vous pouvez augmenter les performances globales en utilisant ainsi que ses SqlDataAdapter objets associés SqlCommand et SqlConnection . Pour les sources de données prises en charge par OLE DB, utilisez avec ses DataAdapter objets et OleDbConnection associésOleDbCommand. Pour les sources de données prises en charge par ODBC, utilisez avec ses DataAdapter objets et OdbcConnection associésOdbcCommand. Pour les bases de données Oracle, utilisez avec ses DataAdapter objets et OracleConnection associésOracleCommand.
Lorsqu’une instance de DataAdapter est 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
| 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
| 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. |
| AcceptChangesDuringUpdate |
Obtient ou définit si AcceptChanges() est appelé pendant un Update(DataSet). |
| 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. |
| 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) |
| FillLoadOption |
Obtient ou définit LoadOption qui détermine comment l'adaptateur remplit DataTable du DbDataReader. |
| MissingMappingAction |
Détermine l'action à effectuer si les données entrantes ne possèdent pas de table ou de colonne correspondante. |
| MissingSchemaAction |
Détermine l'action à effectuer si le schéma DataSet existant ne correspond pas aux données entrantes. |
| ReturnProviderSpecificTypes |
Obtient ou définit si la méthode |
| 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
| CloneInternals() |
Obsolète.
Obsolète.
Obsolète.
Obsolète.
Crée une copie de cette instance 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) |
| CreateTableMappings() |
Crée un DataTableMappingCollection. |
| 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 DataAdapter 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) |
Ajoute ou actualise les lignes de DataSet pour qu'elles correspondent à celles de la source de données. |
| 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. |
| 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é. |
| 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. |
| FillSchema(DataSet, SchemaType) |
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, IDataReader) | |
| 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() |
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éé. |
| 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) |
Appelé lorsqu'une erreur se produit pendant |
| ResetFillLoadOption() |
Réinitialise FillLoadOption à son état par défaut et entraîne une réponse de Fill(DataSet) à AcceptChangesDuringFill. |
| ShouldSerializeAcceptChangesDuringFill() |
Détermine si la propriété AcceptChangesDuringFill doit être persistante. |
| ShouldSerializeFillLoadOption() |
Détermine si la propriété FillLoadOption doit être persistante. |
| ShouldSerializeTableMappings() |
Détermine si un ou plusieurs objets DataTableMapping existent et s'ils doivent être persistants. |
| 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(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". |
É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. |
Implémentations d’interfaces explicites
| IDataAdapter.TableMappings |
Obtient une collection qui indique comment une table source est mappée à une table de jeu de données. |
