Partager via


Comment : définir l'ordre lors de l'exécution d'une mise à jour hiérarchique

Lorsque vous enregistrez des données modifiées dans un groupe de données dans une base de données (avec la mise à jour hiérarchique activée), vous pouvez contrôler l'ordre que le TableAdapterManager utilise pour envoyer les insertions, mises à jour et suppressions individuelles requises pour enregistrer les données. L'ordre par défaut des commandes pour effectuer une mise à jour hiérarchique est le suivant : insertions, mises à jour et suppressions. Le TableAdapterManager fournit une propriété UpdateOrder qui peut être configurée pour exécuter tout d'abord les mises à jour, puis les insertions et enfin les suppressions.

Il est important de comprendre que, par défaut, le TableAdapterManager exécute en premier les insertions, puis les mises à jour et enfin les suppressions pour toutes les tables dans le groupe de données.

La modification de l'ordre des mises à jour pour exécuter tout d'abord les mises à jour peut être utile lorsque vous modifiez les valeurs de clé primaire des enregistrements existants. L'exécution en premier des mises à jour modifie l'enregistrement existant comme prévu. L'exécution des insertions en premier crée un enregistrement car la nouvelle clé primaire n'est pas encore dans la base de données.

Procédure

Pour définir l'ordre dans lequel effectuer une mise à jour hiérarchique

  1. En mode Design, ouvrez le formulaire qui contient le TableAdapterManager qui effectue votre mise à jour.

  2. Cliquez sur TableAdapterManager dans la barre d'état des composants.

  3. Définissez la propriété UpdateOrder dans la Fenêtre Propriétés dans l'ordre requis pour votre application.

Pour définir l'ordre par programme dans lequel effectuer une mise à jour hiérarchique

  • Le code suivant définit le TableAdapterManager pour exécuter toutes les mises à jour, puis toutes les insertions, et enfin toutes les suppressions. Remplacez yourDataSetTableAdapters par un nom valide de votre projet.

    Me.TableAdapterManager.UpdateOrder = _
    yourDataSetTableAdapters.TableAdapterManager.UpdateOrderOption.UpdateInsertDelete
    
    this.tableAdapterManager.UpdateOrder = 
    yourDataSetTableAdapters.TableAdapterManager.UpdateOrderOption.UpdateInsertDelete;
    
  • Le code suivant définit le TableAdapterManager pour exécuter toutes les insertions, puis toutes les mises à jour, et enfin toutes les suppressions. Il s'agit du comportement de TableAdapterManagerpar défaut.

    Me.TableAdapterManager.UpdateOrder = _
    yourDataSetTableAdapters.TableAdapterManager.UpdateOrderOption.InsertUpdateDelete
    
    this.tableAdapterManager.UpdateOrder = 
    yourDataSetTableAdapters.TableAdapterManager.UpdateOrderOption.InsertUpdateDelete;
    

Voir aussi

Tâches

Comment : activer et désactiver la mise à jour hiérarchique

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

Concepts

Vue d'ensemble de la mise à jour hiérarchique

Enregistrement de données dans des groupes de données

Nouveautés du développement d'applications de données