Procédure pas à pas : affichage de données sur un Windows Form
L'un des scénarios les plus courants dans le développement d'application consiste à afficher des données dans un formulaire d'une application Windows. Vous pouvez afficher des données dans un formulaire en faisant glisser des éléments depuis la Sources de données (fenêtre) vers le formulaire. Cette procédure pas à pas crée un formulaire simple qui affiche les données d'une seule table 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 décrit notamment les tâches suivantes :
Création d'un projet d'application Windows.
Création et configuration d'un dataset à l'aide de l'Configuration de source de données (Assistant).
Sélection du contrôle à créer dans le formulaire pendant le 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éation d'un contrôle lié aux données en faisant glisser des éléments depuis la fenêtre Sources de données vers votre 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 de l'application Windows
La première étape consiste à créer un projet d'application Windows.
Pour créer le projet d'application Windows
Dans le menu Fichier, créez un nouveau projet.
Attribuez le nom DisplayingDataonaWindowsForm au projet.
Sélectionnez Application Windows et cliquez sur OK. Pour plus d'informations, consultez Développement d'applications clientes.
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 basée 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 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.
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
Pour cette procédure pas à pas, les données de la table sont présentées dans une vue Détails où les données sont affichées dans des contrôles individuels. (L'autre approche est la vue 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 de 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 Détails dans la liste déroulante du 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 de contrôles 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ôlés liés aux données dans le formulaire
Faites glisser le nœud Customers principal depuis la fenêtre Sources de données vers le formulaire.
Les contrôles liés aux données assortis d'étiquettes descriptives apparaissent dans le formulaire, ainsi qu'une barre d'outils (BindingNavigator) pour parcourir les enregistrements. NorthwindDataSet, CustomersTableAdapter, BindingSource et BindingNavigator s'affichent 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 spécifications de votre application, vous pouvez exécuter différentes étapes après la création d'un formulaire Windows 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.
Ajoutez 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. Ensuite, vous pouvez ajouter 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.
Voir aussi
Concepts
Liaison de contrôles Windows Forms à des données dans Visual Studio
Vue d'ensemble des sources de données
Vue d'ensemble de TableAdapter