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

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

Au cours de cette procédure pas à pas, vous apprendrez à :

• Créez une nouvelle Application Windows.

• Créez et configurez un groupe de données avec l'Configuration de source de données (Assistant).

• Sélectionner le contrôle à créer dans le formulaire lors du déplacement d'éléments depuis la fenêtre Sources de données. 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éer des contrôles liés aux données en faisant glisser des éléments depuis la fenêtre Sources de données sur le formulaire.

• Ajouter des méthodes pour accéder directement à la base de données et effectuer des insertions, des mises à jour et des suppressions directement par rapport à la base de données.

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 d'une application Windows

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

Pour créer le nouveau projet Windows

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

2. Nommez le projet TableAdapterDbDirectMethodsWalkthrough.

3. Sélectionnez Application Windows, puis cliquez sur OK. Pour plus d'informations, consultez Création d'applications Windows.

   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 fournie dans 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 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, 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. 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 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 sur le Windows Form

• Faites glisser le nœud Region depuis la fenêtre Sources de données vers le formulaire.

  Un contrôle DataGridView et une barre d'outils (BindingNavigator) de navigation au sein des enregistrements apparaissent sur le formulaire. Un NorthwindDataSet, un RegionTableAdapter, un BindingSource et un BindingNavigator apparaissent dans la barre d'état des composants.

Pour ajouter des boutons qui appelleront les méthodes DbDirect de TableAdapter

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

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

   Nom	Texte
   InsertButton	Insert
   UpdateButton	Update
   DeleteButton	Supprimer

Pour ajouter le code destiné à l'insertion de nouveaux enregistrements dans la base de données

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

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

   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
   

   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);
   }
   

Pour ajouter le code permettant de mettre à jour des enregistrements dans la base de données

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

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

   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
   

   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();
   }
   

Pour ajouter le code destiné à supprimer des enregistrements de la base de données

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

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

   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
   

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

Exécution de l'application

Pour exécuter l'application

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

• Cliquez sur le bouton Insert et vérifiez que le nouvel enregistrement apparaît dans la grille.

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

• Cliquez sur le bouton Delete et vérifiez 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 :

• 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 tables supplémentaires au groupe de données en sélectionnant Configurer le DataSet à l'aide de l'Assistant dans la fenêtre Sources de données. Vous pouvez ajouter des contrôles qui affichent les données associées en faisant glisser les nœuds associés vers le formulaire. Pour plus d'informations, consultez Comment : afficher des données connexes dans une application Windows Forms.

Voir aussi

Tâches

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

Concepts

Vue d'ensemble de TableAdapter

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

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

Autres ressources

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