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

Article
08/10/2011

L'un des scénarios les plus courants lors du développement d'applications consiste à afficher des données sur un formulaire, à les modifier et à renvoyer les données mises à jour à la base de données. Cette procédure pas à pas crée un formulaire simple qui affiche des données provenant d'une table individuelle dans des contrôles individuels. Vous pouvez modifier les données contenues 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 les 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 éléments depuis la fenêtre Sources de données, le code permettant d'enregistrer les données est automatiquement ajouté pour la première table déplacée jusqu'à un formulaire. Toutes les tables supplémentaires ajoutées à un formulaire exigent l'ajout manuel de tout code nécessaire à l'enregistrement de données. Pour plus d'informations sur l'enregistrement de 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 illustre les tâches suivantes :

Création d'un nouveau projet Application Windows.
Création et configuration d'une source de données dans votre application avec le Configuration de source de données (Assistant).
Définissez les contrôles des éléments dans le 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 jusqu'à votre formulaire.
Modification de quelques enregistrements dans le groupe de données.
Ajout du code pour renvoyer à la base de données les données mises à jour dans le groupe 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 Utilisation des paramètres.

Composants requis

Pour exécuter cette procédure pas à pas, vous devrez :

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'assignation d'un nom au projet est facultative à ce stade, mais nous lui donnons un nom, car nous avons l'intention de l'enregistrer ultérieurement.

Pour créer le nouveau projet Application Windows

Dans le menu Fichier, créez un nouveau projet.
Nommez le projet UpdateSingleTableWalkthrough.
Sélectionnez Application Windows, puis cliquez sur OK. Pour plus d'informations, consultez Création d'applications Windows.

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 l'installation 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. Pour plus d'informations, consultez Ajouter/Modifier une connexion, boîte de dialogue (Général).
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

Dans le cadre de cette procédure pas à pas, les données sont insérées selon une présentation Détails, c'est-à-dire qu'elles sont affichées dans les contrôles individuels, plutôt que selon la présentation par défaut (DataGridView).

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

Développez le nœud Customers dans la fenêtre Sources de données.
Modifiez le type de déplacement de la table Customers en fonction de 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

Vous pouvez créer les contrôles liés aux données en faisant glisser des éléments depuis la fenêtre Sources de données vers votre formulaire.

Pour créer des contrôles liés aux données sur le formulaire

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

Les contrôles liés aux données avec des étiquettes descriptives s'affichent sur le formulaire, ainsi qu'une barre d'outils (BindingNavigator) pour naviguer au sein des enregistrements. Un NorthwindDataSet, un CustomersTableAdapter, un BindingSource et un BindingNavigator apparaissent dans la barre d'état des composants.

Modification du code permettant de 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 pour le bouton Enregistrer de BindingNavigator est ajouté au code du formulaire afin d'envoyer les mises à jour à la base de données. Cette procédure modifie le code pour inclure la gestion des erreurs en encapsulant l'appel de mise à jour dans un bloc try-catch. Vous pouvez modifier le code pour l'adapter aux besoins de votre application.

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

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

Remplacez le code contenu dans le gestionnaire d'événements pour ajouter la gestion des erreurs. Ce 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 des modifications aux données d'un ou plusieurs enregistrements.
Cliquez sur le bouton Enregistrer.
Vérifiez les valeurs contenues dans la base de données pour vérifier que les modifications ont été enregistrées.

Étapes suivantes

Selon les exigences 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 :

Ajouter la 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 qui affichent des données connexes. Pour plus d'informations, consultez Comment : afficher des données connexes dans une application Windows Forms.
Modification de la source de données pour ajouter ou supprimer des objets de base de données. Pour plus d'informations, consultez Comment : modifier un groupe de données.