Partager via


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

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 :

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 :

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

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

  2. Nommez le projet UpdateSingleTableWalkthrough.

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

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

  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

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

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

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

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

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

  1. Appuyez sur F5.

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

  3. Cliquez sur le bouton Enregistrer.

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

Voir aussi

Concepts

Nouveautés du développement d'applications de données

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

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

Autres ressources

Procédures pas à pas relatives aux données

Connexion aux données dans Visual Studio

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

Extraction de données dans votre application

Modification des données dans votre application

Validation des données

Enregistrement des données