Procédure pas à pas : affichage de données sur un Windows Form

Article
08/10/2011

L'un des scénarios les plus courants dans le développement d'application consiste à afficher des données sur un formulaire dans une application Windows. Vous pouvez afficher des données sur un formulaire en faisant glisser des éléments du Sources de données (fenêtre) sur le formulaire. Cette procédure pas à pas crée un formulaire simple qui affiche des données provenant d'une table unique dans plusieurs contrôles individuels. Cet exemple utilise la table Customers de l'exemple de base de données Northwind.

Cette procédure pas à pas illustre les tâches suivantes :

Création d'un nouveau projet Application Windows.
Création et configuration d'un groupe de données avec l'Configuration de source de données (Assistant).
Sélection du contrôle à créer sur le formulaire lors du déplacement d'éléments à partir de 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éation d'un contrôle lié aux données en faisant glisser des éléments depuis la fenêtre Sources de données jusqu'à votre formulaire.

Composants requis

Pour exécuter cette procédure pas à pas, vous devez :

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 de l'application Windows

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

Pour créer le nouveau projet Application Windows

Dans le menu Fichier, créez un nouveau projet.
Nommez le projet DisplayingDataonaWindowsForm.
Sélectionnez Application Windows, puis cliquez sur OK. Pour plus d'informations, consultez Création d'applications Windows.

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

Création de la source de données

Cette étape permet de créer une source 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 la source de données

Dans le menu Données, cliquez sur Afficher les sources de données.
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.
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. 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.

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. (L'autre approche est la présentation Grille par défaut où les données sont affichées dans un contrôle DataGridView.)

Pour définir le type de déplacement des éléments contenus dans la fenêtre Sources de données

Développez le nœud Customers dans la fenêtre Sources de données.
Remplacez le type de déplacement de la table Customers par Détails en sélectionnant cette option dans la liste déroulante située sur le 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.
Remplacez le type de déplacement de la colonne CustomerID par une étiquette en sélectionnant Étiquette dans la liste déroulante du nœud CustomerID.

Création du formulaire

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 formulaire

Faites glisser le nœud Customers depuis la fenêtre Sources de données jusqu'au formulaire.

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.

Test de l'application

Pour exécuter l'application

Appuyez sur F5.
Parcourez les enregistrements à l'aide du contrôle BindingNavigator.

Étapes suivantes

Selon les exigences de votre application, vous pouvez exécuter différentes étapes après la création d'un Windows Form 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.
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. Ensuite, vous pouvez ajouter 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) jusqu'au formulaire. Pour plus d'informations, consultez Comment : afficher des données connexes dans une application Windows Forms.