Procédure pas à pas : enregistrement de données dans une base de données (table unique)

Article
09/12/2015

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 simple qui affiche les données d'une seule table dans des contrôles individuels. Vous pouvez modifier les données dans les contrôles et enregistrer vos modifications dans la base de données. Cet exemple utilise la table Customers 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. Quand vous faites glisser des éléments depuis la fenêtre Sources de données, du code permettant d'enregistrer les données est automatiquement ajouté pour la première table déplacée dans un formulaire. Toutes les tables supplémentaires ajoutées à un formulaire requièrent l'ajout manuel du code requis pour enregistrer les données. Pour des informations sur l'enregistrement des données de plusieurs tables, consultez Procédure pas à pas : enregistrement de données dans une base de données (plusieurs tables).

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

Création d'un projet d'application Windows.
Création et configuration d'une source de données dans votre application à l'aide de l'Configuration de source de données (Assistant).
Définir les contrôles des éléments dans la Sources de données (fenêtre). Pour plus d'informations, consultez Comment : 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éation de contrôles liés aux données en faisant glisser des éléments depuis la fenêtre Sources de données vers votre formulaire.
Modification d'une paire d'enregistrements dans le dataset.
Ajout de code pour renvoyer les données mises à jour dans le dataset à la base de données.

Notes

Les boîtes de dialogue et les commandes de menu qui s'affichent peuvent être différentes de celles qui sont décrites dans l'aide, en fonction de vos paramètres actifs ou de l'édition utilisée.Pour modifier vos paramètres, choisissez Importation et exportation de paramètres dans le menu Outils.Pour plus d'informations, consultez Customizing Development Settings in Visual Studio.

Composants requis

Pour exécuter cette procédure pas à pas, vous avez besoin des éléments suivants :

avoir accès à l'exemple de base de données Northwind. Pour plus d'informations, consultez Comment : installer des exemples de bases de données.

Création de l'application Windows

La première étape consiste à créer une application Windows. L'attribution d'un nom au projet est facultative à ce stade, mais nous lui en donnons un car nous avons l'intention de l'enregistrer ultérieurement.

Pour créer le projet d'application Windows

Dans le menu Fichier, créez un nouveau projet.
Attribuez le nom UpdateSingleTableWalkthrough au projet.
Sélectionnez Application Windows et cliquez sur OK. Pour plus d'informations, consultez Développement d'applications clientes avec .NET Framework.

Le projet UpdateSingleTableWalkthrough est créé et ajouté à l'Explorateur de solutions.

Création de 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 exécuter l'Assistant. Pour plus d'informations sur la configuration de l'exemple de base de données Northwind, consultez Comment : installer des exemples de bases de données.

Pour créer la source de données

Dans le menu Données, cliquez sur Afficher les sources de données.
Dans la fenêtre Sources de données, cliquez sur Ajouter une nouvelle source de données pour démarrer l'Assistant Configuration de source de données.
Sélectionnez Base de données dans la page Choisir un type de source de données, puis cliquez sur Suivant.
Dans la page 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.
Si votre base de données requiert un mot de passe, sélectionnez l'option pour inclure les données sensibles, puis cliquez sur Suivant.
Cliquez sur Suivant dans la page Enregistrer la chaîne de connexion dans le fichier de configuration de l'application.
Développez le nœud Tables dans la page Choisir vos objets de base de données.
Sélectionnez la table Customers, puis cliquez sur Terminer.

NorthwindDataSet est ajouté à votre projet et la table Customers apparaît dans la fenêtre Sources de données.

Définition des contrôles à créer

Pour cette procédure pas à pas, les données sont présentées dans une vue Détails où les données sont affichées dans des contrôles individuels au lieu de la vue DataGridView par défaut.

Pour définir les contrôles pour les éléments de la fenêtre Sources de données

Développez le nœud Customers dans la fenêtre Sources de données.
Remplacez le contrôle de la table Customers par des contrôles individuels en sélectionnant Détails dans la liste déroulante du nœud Customers. Pour plus d'informations, consultez Comment : 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éation du 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.

Pour créer des contrôlés liés aux données dans le formulaire

Faites glisser le nœud Customers principal 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. NorthwindDataSet, CustomersTableAdapter, BindingSource et BindingNavigator s'affichent dans la barre d'état des composants.

Modification du code pour mettre à jour la base de données

Vous pouvez mettre à jour la base de données en appelant la méthode Update du CustomersTableAdapter. Par défaut, un gestionnaire d'événements est ajouté au code du formulaire pour le bouton Enregistrer de BindingNavigator afin d'envoyer des mises à jour à la base de données. Cette procédure modifie le code pour inclure une 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.

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

Double-cliquez sur le bouton Enregistrer de BindingNavigator pour ouvrir l'Éditeur de code sur le gestionnaire d'événements bindingNavigatorSaveItem_Click.

Remplacez le code dans le gestionnaire d'événements pour ajouter une gestion des erreurs. Le code doit se présenter comme suit :

Try
    Me.Validate()
    Me.CustomersBindingSource.EndEdit()
    Me.CustomersTableAdapter.Update(Me.NorthwindDataSet.Customers)
    MsgBox("Update successful")

Catch ex As Exception
    MsgBox("Update failed")
End Try

try
{
    this.Validate();
    this.customersBindingSource.EndEdit();
    this.customersTableAdapter.Update(this.northwindDataSet.Customers);
    MessageBox.Show("Update successful");
}
catch (System.Exception ex)
{
    MessageBox.Show("Update failed");
}

Test de l'application

Pour tester l'application

Appuyez sur F5.
Apportez quelques modifications aux données d'un ou plusieurs enregistrements.
Appuyez sur le bouton Enregistrer.
Vérifiez les valeurs figurant dans la base de données pour confirmer que les modifications ont bien été enregistrées.

Étapes suivantes

Selon les spécifications de votre application, vous pouvez exécuter différentes étapes après la création d'un formulaire lié aux données dans votre application Windows. Vous pouvez apporter à cette procédure pas à pas les améliorations suivantes :

Ajout d'une fonctionnalité de recherche au formulaire. Pour plus d'informations, consultez Comment : ajouter une requête paramétrable à une application Windows Forms.
Ajout de contrôles affichant les données associées. Pour plus d'informations, consultez Comment : afficher des données connexes dans une application Windows Forms.
Modification de la source de données dans le but d'ajouter ou de supprimer des objets de base de données. Pour plus d'informations, consultez Comment : modifier un groupe de données.