Procédure pas à pas : remplissage d'un Dataset avec des données

Article
08/21/2008

Mise à jour : novembre 2007

Cette procédure pas à pas crée un groupe de données avec une table de données et le remplit de données provenant de la table Customers dans l'exemple de base de données Northwind. Le groupe de données est rempli de données grâce à un appel à la méthode Fill d'un TableAdapter.

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

Créer une nouvelle application Windows.
Créer et configurer un groupe de données avec l'Assistant Configuration de source de données.
Créer un contrôle DataGridView lié aux données en faisant glisser des éléments depuis la fenêtre Sources de données vers le formulaire.

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

Dans le menu Fichier de Visual Studio, créez un nouveau Projet.
Nommez le projet ProcédureGroupeDonnées.
Sélectionnez Application Windows, puis cliquez sur OK. Pour plus d'informations, consultez Création d'applications Windows.

Le projet ProcédureGroupeDonnées est créé et ajouté à l'Explorateur de solutions.

Création du NorthwindDataSet

Cette étape permet de créer un groupe de données à l'aide de l'Assistant Configuration de source de données en se basant sur la table Customers 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 le groupe 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 afficher la boîte de dialogue Ajouter une/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.

Ajout de contrôles au formulaire

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 un formulaire dans votre application Windows.

Pour créer un DataGridView lié à la table Customers

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

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

Inspection du code généré qui remplit de données le groupe de données

Faire glisser les éléments de la fenêtre Sources de données sur un formulaire ajoute automatiquement le code correct pour remplir le groupe de données dans le gestionnaire d'événements Form1_Load.

Pour charger des données dans un groupe de données

Sélectionnez Form1 dans l'Explorateur de solutions et cliquez sur le bouton Afficher le code.

Inspectez le gestionnaire d'événements Form1_Load. La méthode Fill du TableAdapter remplit de données le groupe de données.

Private Sub Form1_Load(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles MyBase.Load

    'TODO: This line of code loads data into the 'NorthwindDataSet1.Customers' table.
    'You can move, or remove it, as needed.

    Me.CustomersTableAdapter1.Fill(Me.NorthwindDataSet1.Customers)
End Sub

private void Form1_Load(object sender, EventArgs e)
{
    // TODO: This line of code loads data into the 'northwindDataSet1.Customers' table.
    // You can move, or remove it, as needed.

    this.customersTableAdapter1.Fill(this.northwindDataSet1.Customers);
}

Vous pouvez copier ce code vers d'autres parties de votre application où vous devez remplir le groupe de données.

Exécution de l'application

Pour exécuter l'application

Appuyez sur F5 pour exécuter l'application.
Le groupe de données est rempli avec les données et affiché dans le contrôle DataGridView.

É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. 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étrée à un formulaire dans une application Windows.
Ajouter la fonctionnalité permettant de renvoyer les mises à jour à la base de données. Pour plus d'informations, consultez Procédure pas à pas : enregistrement de données dans une base de données (table unique).
Ajouter la table Orders au groupe de données en sélectionnant Configurer le DataSet à l'aide de l'Assistant dans la fenêtre Sources de données. Ajoutez à présent des contrôles qui affichent les données connexes en faisant glisser le nœud Orders (situé sous la colonne Fax de la table Customers) vers le formulaire. Pour plus d'informations, consultez Comment : afficher des données liées dans une application Windows.