Partager via


Vue d'ensemble de TableAdapterManager

Le TableAdapterManager est un composant qui permet d'enregistrer des données dans les tables de données connexes. Le TableAdapterManager utilise les relations de clé étrangère qui lient les tables de données pour déterminer l'ordre approprié d'envoi des insertions, des mises à jour et des suppressions à partir d'un groupe de données à la base de données sans violer les contraintes de clé étrangère (intégrité référentielle) dans la base de données.

Les contraintes de clé étrangère sont les règles de cohérence dans une base de données qui contrôlent le comportement des enregistrements liés aux insertions, mises à jour et suppressions. Les contraintes de clé étrangère empêchent la suppression des enregistrements parents si des enregistrements enfants connexes existent encore dans une autre table.

Le processus global d'enregistrement des données dans les tables de données connexes à l'aide d'un TableAdapterManager est appelé Mise à jour hiérarchique.

L'enregistrement des données modifiées des tables de données connexes est une opération un peu plus complexe que l'enregistrement des données d'une table individuelle. Les commandes INSERT, UPDATE et DELETE pour chaque table connexe doivent être exécutées dans un ordre spécifique pour éviter de violer les contraintes de clé étrangère définies dans la base de données. Prenons l'exemple d'une application d'enregistrement de commandes avec laquelle vous pouvez gérer à la fois les commandes et les clients nouveaux et existants. Si vous devez supprimer un enregistrement de client existant, vous devez tout d'abord supprimer tous les commandes de ce client. Si vous ajoutez un nouvel enregistrement de client (avec une commande), vous devez tout d'abord insérer le nouvel enregistrement de client avant d'insérer les commandes de ce client à cause des contraintes de clé étrangère qui sont dans les tables. Ces exemples montrent que vous devez extraire des sous-ensembles spécifiques de données et envoyer les mises à jour (insertions, mises à jour et suppressions) dans l'ordre approprié pour maintenir l'intégrité référentielle et éviter des conflits avec les contraintes de clé étrangère dans la base de données.

Création de TableAdapterManagers

Par défaut, une classe TableAdapterManager est générée lorsque vous créez un groupe de données typé dans un projet. Plus spécifiquement, il s'agit de la valeur dans la propriété Hierarchical Update d'un groupe de données qui détermine si un TableAdapterManager est créé. Si Hierarchical Update a la valeur True, un TableAdapterManager est créé ; si Hierarchical Update a la valeur False, un groupe de données qui ne contient pas de TableAdapterManager est créé. Pour plus d'informations, consultez Comment : activer et désactiver la mise à jour hiérarchique.

Notes

Par défaut, la propriété Hierarchical Update des groupes de données ajoutés aux projets créés dans les précédentes versions de Visual Studio a la valeur False. Cela signifie que la mise à jour hiérarchique est désactivée et qu'aucun TableAdapterManager n'est créé. Pour plus d'informations sur l'ajout d'un TableAdapterManager à un groupe de données existant, consultez Comment : implémenter une mise à jour hiérarchique dans des projets Visual Studio existants.

Référence TableAdapterManager

La classe TableAdapterManager ne fait pas partie de .NET Framework. Par conséquent, vous ne pouvez pas la chercher dans la documentation. Elle est créée au moment du design dans le cadre du processus de création de groupe de données.

Les éléments suivants sont les méthodes et propriétés fréquemment utilisées de la classe TableAdapterManager :

Membre

Description

Méthode UpdateAll

Enregistre toutes les données de toutes les tables de données.

Propriété BackUpDataSetBeforeUpdate

Valeur booléenne. Détermine s'il faut créer une copie de sauvegarde du groupe de données avant d'exécuter la méthode TableAdapterManager.UpdateAll.

Propriété NomTableTableAdapter

Représente un TableAdapter. Le TableAdapterManager généré contient une propriété pour chaque TableAdapter qu'il gère. Par exemple, un groupe de données avec une table Customers et Orders est générée avec un TableAdapterManager qui contient des propriétés CustomersTableAdapter et OrdersTableAdapter.

Propriété UpdateOrder

Contrôle l'ordre d'exécution des commandes individuelles INSERT, UPDATE et DELETE. Affectez-lui une des valeurs de l'énumération TableAdapterManager.UpdateOrderOption.

Par défaut, l' UpdateOrder a la valeur InsertUpdateDelete. Cela signifie que les insertions, puis les mises à jour et enfin les suppressions sont exécutées pour toutes les tables dans le groupe de données. Pour plus d'informations, consultez Comment : définir l'ordre lors de l'exécution d'une mise à jour hiérarchique.

Voir aussi

Tâches

Procédure pas à pas : enregistrement des données de tables de données connexes (Mise à jour hiérarchique)

Procédure pas à pas : création d'une application de données simple

Concepts

Vue d'ensemble de TableAdapter

Autres ressources

Mise à jour hiérarchique

Enregistrement des données