Partager via

Procédure pas à pas : enregistrement des données avec les méthodes DBDirect du TableAdapter

  • Article

 

Date de publication : mars 2016

Cette procédure pas à pas fournit des instructions détaillées pour exécuter des instructions SQL directement sur une base de données à l'aide des méthodes DBDirect d'un TableAdapter. Les méthodes DBDirect d'un TableAdapter fournissent un niveau élevé de contrôle sur vos mises à jour de base de données. Elles vous permettent d'exécuter des instructions SQL et des procédures stockées spécifiques en appelant les méthodes Insert, Update et Delete individuelles selon les besoins de votre application (au lieu de la méthode Update surchargée qui exécute les instructions UPDATE, INSERT et DELETE dans un seul appel).

Pendant cette procédure pas à pas, vous allez apprendre à :

Composants requis

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

Création d'une application Windows

La première étape consiste à créer une application Windows.

Pour créer un projet Windows

  1. Dans Visual Studio, dans le menu Fichier, créez un Projet.

  2. Attribuez le nom TableAdapterDbDirectMethodsWalkthrough au projet.

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

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

Création d'une source de données à partir de votre base de données

Cette étape utilise l'Assistant Configuration de source de données pour créer une source de données basée sur la table Region de l'exemple de base de données Northwind. 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 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, sélectionnez 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 afficher 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 Region, puis cliquez sur Terminer.

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

Ajout de contrôles au formulaire pour afficher les données

Créez 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 dans le formulaire Windows

Pour ajouter des boutons pour appeler les méthodes DbDirect individuelles de TableAdapter

  1. Faites glisser trois contrôles Button depuis la Boîte à outils vers Form1 (sous le RegionDataGridView).

  2. Définissez les propriétés Name et Text suivantes sur chaque bouton.

    Nom Texte
    InsertButton Insert
    UpdateButton Mettre à jour
    DeleteButton Supprimer

Pour ajouter du code afin d'insérer de nouveaux enregistrements dans la base de données

  1. Double-cliquez sur InsertButton pour créer un gestionnaire d'événements pour l'événement Click et ouvrir votre formulaire dans l'éditeur de code.

  2. Remplacez le gestionnaire d'événements InsertButton_Click par le code suivant :

            private void InsertButton_Click(object sender, EventArgs e)
        {
            Int32 newRegionID = 5;
            String newRegionDescription = "NorthEastern";

            try
            {
                regionTableAdapter1.Insert(newRegionID, newRegionDescription);
            }
            catch (Exception ex)
            {
                MessageBox.Show("Insert Failed");
            }
            RefreshDataset();
        }


        private void RefreshDataset()
        {
            this.regionTableAdapter1.Fill(this.northwindDataSet1.Region);
        }

        Private Sub InsertButton_Click() Handles InsertButton.Click

        Dim newRegionID As Integer = 5
        Dim newRegionDescription As String = "NorthEastern"

        Try
            RegionTableAdapter1.Insert(newRegionID, newRegionDescription)

        Catch ex As Exception
            MessageBox.Show("Insert Failed")
        End Try

        RefreshDataset()
    End Sub


    Private Sub RefreshDataset()
        Me.RegionTableAdapter1.Fill(Me.NorthwindDataSet1._Region)
    End Sub

Pour ajouter du code afin de mettre à jour des enregistrements dans la base de données

  1. Double-cliquez sur UpdateButton pour créer un gestionnaire d'événements pour l'événement Click et ouvrir votre formulaire dans l'éditeur de code.

  2. Remplacez le gestionnaire d'événements UpdateButton_Click par le code suivant :

            private void UpdateButton_Click(object sender, EventArgs e)
        {
            Int32 newRegionID = 5;

            try
            {
                regionTableAdapter1.Update(newRegionID, "Updated Region Description", 5, "NorthEastern");
            }
            catch (Exception ex)
            {
                MessageBox.Show("Update Failed");
            }
            RefreshDataset();
        }

        Private Sub UpdateButton_Click() Handles UpdateButton.Click

        Dim newRegionID As Integer = 5

        Try
            RegionTableAdapter1.Update(newRegionID, "Updated Region Description", 5, "NorthEastern")

        Catch ex As Exception
            MessageBox.Show("Update Failed")
        End Try

        RefreshDataset()
    End Sub

Pour ajouter du code afin de supprimer des enregistrements dans la base de données

  1. Double-cliquez sur DeleteButton pour créer un gestionnaire d'événements pour l'événement Click et ouvrir votre formulaire dans l'éditeur de code.

  2. Remplacez le gestionnaire d'événements DeleteButton_Click par le code suivant :

            private void DeleteButton_Click(object sender, EventArgs e)
        {
            try
            {
                regionTableAdapter1.Delete(5, "Updated Region Description");
            }
            catch (Exception ex)
            {
                MessageBox.Show("Delete Failed");
            }
            RefreshDataset();
        }

        Private Sub DeleteButton_Click() Handles DeleteButton.Click

        Try
            RegionTableAdapter1.Delete(5, "Updated Region Description")

        Catch ex As Exception
            MessageBox.Show("Delete Failed")
        End Try

        RefreshDataset()
    End Sub

Exécution de l'application

Pour exécuter l'application

  • Appuyez sur F5 pour exécuter l'application.

  • Cliquez sur le bouton Insérer et vérifier que le nouvel enregistrement apparaît dans la grille.

  • Cliquez sur le bouton Mettre à jour et vérifier que l'enregistrement est mis à jour dans la grille.

  • Cliquez sur le bouton Supprimer et vérifier que l'enregistrement est supprimé de la grille.

É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. Vous pouvez apporter à cette procédure pas à pas les améliorations suivantes :

Voir aussi

Vue d'ensemble de TableAdapter
Comment : accéder directement à la base de données avec un TableAdapter
Comment : créer des requêtes TableAdapter
Comment : enregistrer les données d'un objet dans une base de données
Liaison de contrôles Windows Forms à des données dans Visual Studio
Connexion aux 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