Partager via

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

  • Article

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 :

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 Paramètres Visual Studio.

Composants requis

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

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

  1. Dans le menu Fichier, créez un nouveau projet.

  2. Attribuez le nom UpdateSingleTableWalkthrough au projet.

  3. Sélectionnez Application Windows et cliquez sur OK. Pour plus d'informations, consultez Développement d'applications clientes.

    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

  1. Dans le menu Données, cliquez sur Afficher les sources de données.

  2. 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.

  3. Sélectionnez Base de données dans la page Choisir un type de source de données, puis cliquez sur Suivant.

  4. 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.

  5. 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.

  6. Cliquez sur Suivant dans la page Enregistrer la chaîne de connexion dans le fichier de configuration de l'application.

  7. Développez le nœud Tables dans la page Choisir vos objets de base de données.

  8. 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

  1. Développez le nœud Customers dans la fenêtre Sources de données.

  2. 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

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

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

  2. 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

  1. Appuyez sur F5.

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

  3. Appuyez sur 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.

É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 :

Voir aussi

Concepts

Liaison de contrôles Windows Forms à des données dans Visual Studio

Préparation de votre application pour recevoir des données

Extraction de données dans votre application

Liaison de contrôles à des données dans Visual Studio

Modification des données dans votre application

Validation des données

Enregistrement des données

Autres ressources

Procédures pas à pas relatives aux données

Connexion aux données dans Visual Studio