Partager via

Guide d’utilisation : Sauvegarder des données dans une transaction dans les applications .NET Framework

  • Article

Remarque

Les jeux de données et les classes associées sont des technologies .NET Framework héritées qui datent du début des années 2000. Elles permettent aux applications d’utiliser des données en mémoire pendant que les applications sont déconnectées de la base de données. Ces technologies sont particulièrement utiles aux applications qui permettent aux utilisateurs de modifier des données, et de rendre ces changements persistants dans la base de données. Même si les jeux de données sont une technologie très efficace, nous vous recommandons d’utiliser Entity Framework Core pour les nouvelles applications .NET. Entity Framework offre un moyen plus naturel d’utiliser des données tabulaires en tant que modèles objet. De plus, il présente une interface de programmation plus simple.

Ce guide pas à pas décrit comment enregistrer les données dans une transaction à l’aide de l’espace de noms System.Transactions. Dans ce guide pas à pas, vous allez créer une application Windows Forms. Vous allez utiliser l’Assistant Configuration de source de données pour créer un jeu de données pour deux tables dans l’exemple de base de données Northwind. Vous allez ajouter des contrôles liés aux données à un formulaire Windows et modifier le code du bouton Enregistrer de BindingNavigator pour mettre à jour la base de données à l’intérieur d’un TransactionScope.

Prérequis

Pour effectuer ce tutoriel, vous devez installer les charges de travail Développement de bureau .NET et Stockage et traitement des données dans Visual Studio. Pour les installer, ouvrez Visual Studio Installer et choisissez Modifier (ou Plus>Modifier) en regard de la version de Visual Studio que vous souhaitez modifier. Consultez Modifier Visual Studio.

Cette procédure pas à pas utilise SQL Server Express LocalDB et l’exemple de base de données Northwind.

  1. Si SQL Server Express LocalDB n’est pas installé, installez-le à partir de la page de téléchargement SQL Server Express, ou via le programme d’installation Visual Studio Installer. Dans Visual Studio Installer, SQL Server Express LocalDB peut être installé dans le cadre de la charge de travail Développement .NET Desktop, ou l’installer comme un composant seul.

  2. Installez l’exemple de base de données Northwind en procédant comme suit :

    1. Dans Visual Studio, ouvrez la fenêtre de l’Explorateur d’objets SQL Server. (L’Explorateur d’objets SQL Server est installé dans le cadre de la charge de travail stockage de données et du traitement dans Visual Studio Installer.) Développez le nœud SQL Server. Cliquez avec le bouton droit sur votre instance LocalDB et sélectionnez Nouvelle requête.

      Une fenêtre d’éditeur de requête s’ouvre.

    2. Copiez le script Northwind Transact-SQL dans votre Presse-papiers. Ce script T-SQL crée la base de données Northwind à partir de zéro et la remplit avec des données.

    3. Collez le script T-SQL dans l’éditeur de requête, puis cliquez sur le bouton Exécuter.

      Peu de temps après, la requête se termine et la base de données Northwind est créée.

Créer une application Windows Forms

La première étape consiste à créer une application Windows Forms (.NET Framework).

  1. Dans Visual Studio, dans le menu Fichier, sélectionnez Nouveau>Projet.

  2. Développez Visual C# ou Visual Basic dans le volet gauche, puis sélectionnez Windows Desktop.

  3. Dans le volet central, sélectionnez le type de projet d’application Windows Forms.

  4. Nommez le projet SavingDataInATransactionWalkthrough, puis choisissez OK.

    Le projet SavingDataInATransactionWalkthrough est créé et ajouté à l’Explorateur de solutions.

Créer une source de données de base de données

Cette étape utilise l’Assistant Configuration de source de données pour créer une source de données basée sur les tables Customers et Orders de l’exemple de base de données Northwind.

  1. Pour ouvrir la fenêtre Sources de données, dans le menu Données, sélectionnez Afficher les sources de données.

  2. Dans la fenêtre Sources de données, sélectionnez Ajouter une nouvelle source de données pour démarrer l’Assistant Configuration de source de données.

  3. Sur l’écran Choisir un type de source de données, sélectionnez Base de données, puis Suivant.

  4. Sur l’écran Choisir votre connexion de données, effectuez l’une des opérations suivantes :

    • Si une connexion de données à l'exemple de base de données Northwind est disponible dans la liste déroulante, sélectionnez-la.

      -ou-

    • Sélectionnez Nouvelle connexion pour lancer la boîte de dialogue Ajouter/Modifier une connexion et créez une connexion à la base de données Northwind.

  5. Si votre base de données nécessite un mot de passe, sélectionnez l’option pour inclure les données sensibles, puis cliquez sur Suivant.

  6. Dans l’écran Enregistrer la chaîne de connexion dans le fichier Configuration de l’application, sélectionnez Suivant.

  7. Sur l’écran Choisir vos objets de base de données, développez le nœud Tables.

  8. Sélectionnez les tables Customers et Orders, puis sélectionnez Terminer.

    NorthwindDataSet est ajouté à votre projet et les tables Customers et Orders apparaissent dans la fenêtre Sources de données.

Ajouter des contrôles au formulaire

Pour créer des contrôles liés aux données, vous pouvez faire glisser des éléments depuis la fenêtre Sources de données vers votre formulaire.

  1. Dans la fenêtre Sources de données, développez le nœud Clients.

  2. Faites glisser le nœud Customers depuis la fenêtre Sources de données vers Form1.

    Un contrôle DataGridView et une barre d'outils (BindingNavigator) pour parcourir les enregistrements apparaissent dans le formulaire. Un NorthwindDataSet, CustomersTableAdapter, BindingSourceet BindingNavigator apparaissent dans la barre d’état des composants.

  3. Faites glisser le nœud Commandes associé (pas le nœud Commandes principal, mais celui associé au nœud de table enfant, en dessous de la colonne Fax) vers le formulaire sous le CustomersDataGridView.

    Un DataGridView s'affiche dans le formulaire. Un OrdersTableAdapter et BindingSource apparaissent dans la barre d’état des composants.

Ajouter une référence à l’assembly System.Transactions

Les transactions utilisent l’espace de noms System.Transactions. Une référence de project vers l'assembly system.transactions n'est pas ajoutée par défaut, vous devez donc l'ajouter manuellement.

Pour ajouter une référence au fichier DLL System.Transactions

  1. Dans le menu Projet, sélectionnez Ajouter une référence.

  2. Sélectionnez System.Transactions (sous l’onglet .NET), puis sélectionnez OK.

    Une référence à System.Transactions est ajoutée au projet.

Modifier le code dans le bouton SaveItem de BindingNavigator

Pour la première table déposée dans votre formulaire, du code est ajouté par défaut à l’événement click du bouton d’enregistrement sur le BindingNavigator. Vous devez manuellement ajouter du code pour mettre à jour toutes les tables supplémentaires. Pour ce guide pas à pas, nous refactorisons le code d’enregistrement existant en dehors du gestionnaire d’événements du bouton de sauvegarde. Nous créons également quelques méthodes supplémentaires pour fournir une fonctionnalité de mise à jour spécifique, selon que la ligne doit être ajoutée ou supprimée.

Pour modifier le code d'enregistrement généré automatiquement

  1. Sélectionnez le bouton Enregistrer sur CustomersBindingNavigator (le bouton avec l’icône représentant une disquette).

  2. Remplacez la méthode CustomersBindingNavigatorSaveItem_Click par le code suivant :

    private void customersBindingNavigatorSaveItem_Click(object sender, EventArgs e)
{
    UpdateData();
}

private void UpdateData()
{
    this.Validate();
    this.customersBindingSource.EndEdit();
    this.ordersBindingSource.EndEdit();

    using (System.Transactions.TransactionScope updateTransaction = 
        new System.Transactions.TransactionScope())
    {
        DeleteOrders();
        DeleteCustomers();
        AddNewCustomers();
        AddNewOrders();

        updateTransaction.Complete();
        northwindDataSet.AcceptChanges();
    }
}

L'ordre de rapprochement des modifications des données associées est comme suit :

  • Supprimez les enregistrements enfants. (Dans ce cas, supprimez les enregistrements de la table Orders.)

  • Supprimez les enregistrements parents. (Dans ce cas, supprimez les enregistrements de la table Customers.)

  • Insérez des enregistrements parents. (Dans ce cas, insérez des enregistrements dans la table Customers.)

  • Insérer des enregistrements enfants. (Dans ce cas, insérez des enregistrements dans la table Orders.)

Pour supprimer des commandes existantes

  • Ajoutez la méthode DeleteOrders suivante à Form1 :

    private void DeleteOrders()
{
    NorthwindDataSet.OrdersDataTable deletedOrders;
    deletedOrders = (NorthwindDataSet.OrdersDataTable)
        northwindDataSet.Orders.GetChanges(DataRowState.Deleted);

    if (deletedOrders != null)
    {
        try
        {
            ordersTableAdapter.Update(deletedOrders);
        }
        catch (System.Exception ex)
        {
            MessageBox.Show("DeleteOrders Failed");
        }
    }
}

Pour supprimer des clients existants

  • Ajoutez la méthode DeleteCustomers suivante à Form1 :

    private void DeleteCustomers()
{
    NorthwindDataSet.CustomersDataTable deletedCustomers;
    deletedCustomers = (NorthwindDataSet.CustomersDataTable)
        northwindDataSet.Customers.GetChanges(DataRowState.Deleted);

    if (deletedCustomers != null)
    {
        try
        {
            customersTableAdapter.Update(deletedCustomers);
        }
        catch (System.Exception ex)
        {
            MessageBox.Show("DeleteCustomers Failed");
        }
    }
}

Pour ajouter de nouveaux clients

  • Ajoutez la méthode AddNewCustomers suivante à Form1 :

    private void AddNewCustomers()
{
    NorthwindDataSet.CustomersDataTable newCustomers;
    newCustomers = (NorthwindDataSet.CustomersDataTable)
        northwindDataSet.Customers.GetChanges(DataRowState.Added);

    if (newCustomers != null)
    {
        try
        {
            customersTableAdapter.Update(newCustomers);
        }
        catch (System.Exception ex)
        {
            MessageBox.Show("AddNewCustomers Failed");
        }
    }
}

Pour ajouter de nouvelles commandes

  • Ajoutez la méthode AddNewOrders suivante à Form1 :

    private void AddNewOrders()
{
    NorthwindDataSet.OrdersDataTable newOrders;
    newOrders = (NorthwindDataSet.OrdersDataTable)
        northwindDataSet.Orders.GetChanges(DataRowState.Added);

    if (newOrders != null)
    {
        try
        {
            ordersTableAdapter.Update(newOrders);
        }
        catch (System.Exception ex)
        {
            MessageBox.Show("AddNewOrders Failed");
        }
    }
}

Exécution de l'application

Appuyez sur F5 pour exécuter l'application.

Contenu connexe