Enregistrez des données dans une base de données (plusieurs tables) 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. Elles 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.

L'un des scénarios les plus courants dans le développement d'applications consiste à afficher des données dans un formulaire d'une application Windows, à modifier ces données, puis à renvoyer les données mises à jour à la base de données. Cette procédure pas à pas crée un formulaire affichant les données de deux tables associées et indique comment modifier les enregistrements et enregistrer les modifications dans la base de données. Cet exemple utilise les tables Customers et Orders de l'exemple de base de données Northwind.

Vous pouvez enregistrer des données de votre application dans la base de données en appelant la méthode Update d'un TableAdapter. Lorsque vous faites glisser des tables de la fenêtre Sources de données vers un formulaire, le code requis pour enregistrer les données est automatiquement ajouté. Toutes les tables supplémentaires ajoutées à un formulaire nécessitent l’ajout manuel de ce code. Cette procédure pas à pas indique comment ajouter du code pour enregistrer les mises à jour de plusieurs tables.

Cette procédure pas à pas décrit notamment les tâches suivantes :

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, vous pouvez installer la base de données locale SQL Server Express dans le cadre de la charge de travail Traitement et stockage de données, 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.

      Après un court laps de temps, la requête se termine et la base de données Northwind est créée.

Pour créer une Application Windows Forms

Créez un projet application Windows Forms pour C# ou Visual Basic. Attribuez le nom UpdateMultipleTablesWalkthrough au projet.

Créer la source de données

Cette étape crée une source de données à partir de la base de données Northwind à l’aide de l’Assistant Configuration de source de données. Vous devez avoir accès à l'exemple de base de données Northwind pour créer la connexion. Pour plus d’informations sur la configuration de l’exemple de base de données Northwind, consultez Guide pratique pour installer des exemples de bases de données.

  1. Dans le menu Données, sélectionnez Afficher les sources de données.

    La fenêtre Sources de données s’ouvre.

  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. Dans 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 ouvrir la boîte de dialogue Ajouter/Modifier la connexion.

  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. Sur la page Enregistrer la chaîne de connexion dans le fichier de configuration de l’application, cliquez sur Suivant.

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

  8. Sélectionnez les tables Clients et Commandes, puis cliquez sur Terminer.

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

Définir les contrôles à créer

Pour cette procédure pas à pas, les données de la table Customers se trouvent dans une disposition Détails où les données sont affichées dans des contrôles individuels. Les données de la table Orders se trouvent dans une disposition Grille affichée dans un contrôle DataGridView.

Pour définir le type de déplacement des éléments de la fenêtre Sources de données

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

  2. Sur le nœud Clients, sélectionnez Détails dans la liste de contrôles pour remplacer le contrôle de la table Clients par des contrôles individuels. Pour plus d’informations, consultez Définir le contrôle à créer lors d’une opération de glisser-déplacer à partir de la fenêtre Sources de données.

Créer le formulaire lié aux données

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. Faites glisser le nœud Customers depuis la fenêtre Sources de données vers Form1.

    Les contrôles liés aux données assortis d'étiquettes descriptives apparaissent dans le formulaire, ainsi qu'une barre d'outils (BindingNavigator) pour parcourir les enregistrements. Un NorthwindDataSet, CustomersTableAdapter, BindingSourceet BindingNavigator apparaissent dans la barre d’état des composants.

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

    Notes

    Le nœud Orders associé est situé sous la colonne Fax et constitue un nœud enfant du nœud Customers.

    Un contrôle DataGridView et une barre d'outils (BindingNavigator) pour parcourir les enregistrements apparaissent dans le formulaire. Un élément OrdersTableAdapter et BindingSource apparaissent dans la barre d’état des composants.

Ajout de code pour mettre à jour la base de données

Vous pouvez mettre à jour la base de données en appelant les méthodes Update des TableAdapters Customers et Orders. Par défaut, un gestionnaire d’événements pour le bouton Enregistrer de BindingNavigator est ajouté au code du formulaire pour envoyer des mises à jour à la base de données. Cette procédure modifie le code pour envoyer des mises à jour dans le bon ordre. Cela élimine la possibilité de déclencher des erreurs d’intégrité référentielle. Le code implémente également la gestion des erreurs en enveloppant l'appel de mise à jour dans un bloc try-catch. Vous pouvez modifier le code pour répondre aux besoins de votre application.

Notes

Pour plus de clarté, cette procédure pas à pas n’utilise pas de transaction. Toutefois, si vous mettez à jour deux tables associées ou plus, incluez toute la logique de mise à jour dans une transaction. Une transaction est un processus qui garantit que toutes les modifications associées apportées à une base de données sont réussies avant de les valider. Pour plus d’informations, consultez Transactions et concurrence.

Pour ajouter une logique de mise à jour à l'application

  1. Sélectionnez le bouton Enregistrer sur BindingNavigator. Cela ouvre l’Éditeur de code au gestionnaire d’événements bindingNavigatorSaveItem_Click.

  2. Remplacez le code dans le gestionnaire d'événements pour appeler les méthodes Update des TableAdapters associés. Le code suivant crée d'abord trois tables de données temporaires pour contenir les informations mises à jour pour chaque DataRowState (Deleted, Added et Modified). Les mises à jour sont exécutées dans le bon ordre. Le code doit se présenter comme suit :

    this.Validate();
this.ordersBindingSource.EndEdit();
this.customersBindingSource.EndEdit();

NorthwindDataSet.OrdersDataTable deletedOrders = (NorthwindDataSet.OrdersDataTable)
    northwindDataSet.Orders.GetChanges(DataRowState.Deleted);

NorthwindDataSet.OrdersDataTable newOrders = (NorthwindDataSet.OrdersDataTable)
    northwindDataSet.Orders.GetChanges(DataRowState.Added);

NorthwindDataSet.OrdersDataTable modifiedOrders = (NorthwindDataSet.OrdersDataTable)
    northwindDataSet.Orders.GetChanges(DataRowState.Modified);

try
{
    // Remove all deleted orders from the Orders table.
    if (deletedOrders != null)
    {
        ordersTableAdapter.Update(deletedOrders);
    }

    // Update the Customers table.
    customersTableAdapter.Update(northwindDataSet.Customers);

    // Add new orders to the Orders table.
    if (newOrders != null)
    {
        ordersTableAdapter.Update(newOrders);
    }

    // Update all modified Orders.
    if (modifiedOrders != null)
    {
        ordersTableAdapter.Update(modifiedOrders);
    }

    northwindDataSet.AcceptChanges();
}

catch (System.Exception ex)
{
    MessageBox.Show("Update failed");
}

finally
{
    if (deletedOrders != null)
    {
        deletedOrders.Dispose();
    }
    if (newOrders != null)
    {
        newOrders.Dispose();
    }
    if (modifiedOrders != null)
    {
        modifiedOrders.Dispose();
    }
}

Test de l’application

  1. Appuyez sur F5.

  2. Apportez quelques modifications aux données d'un ou plusieurs enregistrements dans chaque table.

  3. Sélectionnez le bouton Enregistrer.

  4. Vérifiez les valeurs figurant dans la base de données pour confirmer que les modifications ont bien été enregistrées.

Contenu connexe