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

Article
06/10/2015

Cette procédure pas à pas crée un dataset avec une seule table de données et la remplit avec des données de la table Customers de l'exemple de base de données Northwind. Le dataset est rempli avec des données en appelant la méthode Fill d'un TableAdapter.

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

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

Composants requis

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

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 un projet Windows

Dans Visual Studio, dans le menu Fichier, créez un Projet.
Attribuez le nom DatasetWalkthrough au projet.
Sélectionnez Application Windows et cliquez sur OK. Pour plus d'informations, consultez Développement d'applications clientes.

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

Création de NorthwindDataSet

Cette étape permet de créer un dataset à l'aide de l'Assistant Configuration de source de données basé sur la table Customers 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 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/Modifier la connexion.
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

Pour créer des contrôles liés aux données, faites glisser des éléments depuis la fenêtre Sources de données vers un formulaire de votre application Windows.

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

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

Un contrôle DataGridView et une barre d'outils (BindingNavigator) pour parcourir les enregistrements apparaissent dans le formulaire. NorthwindDataSet, CustomersTableAdapter, BindingSource et BindingNavigator s'affichent dans la barre d'état des composants.

Inspection du code généré qui remplit le dataset avec des données

En faisant glisser des éléments depuis la fenêtre Sources de données vers un formulaire, vous ajoutez automatiquement le code approprié pour remplir le dataset dans le gestionnaire d'événements Form1_Load.

Pour charger des données dans un dataset

Dans l'Explorateur de solutions, sélectionnez Form1 et cliquez sur le bouton Afficher le code.

Inspectez le gestionnaire d'événements Form1_Load. La méthode Fill du TableAdapter remplit le dataset avec des données.

Private Sub Form1_Load() 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 éventuellement copier ce code dans d'autres parties de votre application pour lesquelles vous devez remplir le dataset.

Exécution de l'application

Pour exécuter l'application

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

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

Ajout d'une fonctionnalité de recherche au formulaire. Pour plus d'informations, consultez Comment : ajouter une requête paramétrable à une application Windows Forms.
Ajout d'une fonctionnalité pour renvoyer des 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).
Ajout de la table Orders au dataset en sélectionnant Configurer le DataSet à l'aide de l'Assistant dans la fenêtre Sources de données. Ajoutez maintenant des contrôles affichant les données associées en faisant glisser le nœud Orders (celui qui se trouve sous la colonne Fax dans la table Customers) vers le formulaire. Pour plus d'informations, consultez Comment : afficher des données connexes dans une application Windows Forms.