Procédure pas à pas : création d'une application de données simple

Article
08/21/2008

Mise à jour : novembre 2007

L'un des scénarios les plus courants dans le développement d'application consiste à afficher des données provenant d'une base de données dans un Windows Form. Vous pouvez afficher des données dans des formulaires dans les applications Windows en faisant glisser des éléments depuis la Sources de données, fenêtre jusqu'à votre formulaire. Cette procédure pas à pas montre comment créer une application qui affiche des données de deux tables connexes dans une base de données.

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

Création d'une application Windows.
Création et configuration d'un groupe de données basé sur les tables Customers et Orders dans la base de données Northwind à l'aide de l'Assistant Configuration de source de données.
Ajout de contrôles pour afficher des données de la table Customers.
Ajout de contrôles pour afficher les commandes basées sur le client sélectionné.
Test de l'application, sélection de différents clients et vérification de l'affichage des commandes correctes pour le client sélectionné.
Modification de données et enregistrement dans la base de données.

lien vers la vidéo Pour une présentation vidéo, consultez la page Vidéo : création d'une application de données simple.

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 du projet

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

Remarque :
Il se peut que votre ordinateur affiche des noms ou des emplacements différents pour certains éléments de l'interface utilisateur Visual Studio mentionnés dans les instructions suivantes. L'édition de Visual Studio dont vous disposez et les paramètres que vous utilisez déterminent ces éléments. Pour plus d'informations, consultez Paramètres Visual Studio.

Pour créer le projet

Dans le menu Fichier, créez un nouveau projet.
Sélectionnez Application Windows et nommez-la DataWalkthrough. Pour plus d'informations, consultez Création d'applications Windows.
Cliquez sur OK.

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

Création de la source de données

Cette étape permet de créer un groupe de données à partir des tables Customers et Orders dans l'exemple de base de données Northwind à l'aide de l'Assistant Configuration de source 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, cliquez sur le bouton Ajouter une nouvelle source de données dans la barre d'outils 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 les tables Customers et Orders, puis cliquez sur Terminer.

NorthwindDataSet est ajouté à votre projet et les tables Customers et Orders apparaissent dans la fenêtre Sources de données.

Création de contrôles permettant d'afficher des données de la table Customers

Pour créer des contrôles liés aux données, faites glisser des éléments depuis la fenêtre Sources de données jusqu'à un Windows Form.

Pour créer des contrôles afin d'afficher les données des clients (enregistrements parents)

Dans la fenêtre Sources de données, sélectionnez la table Customers, puis cliquez sur la flèche de déroulement.
Sélectionnez Détails dans la liste de contrôles de la table Customer.
Faites glisser le nœud Customers depuis la fenêtre Sources de données vers Form1.

Les contrôles liés aux données avec des étiquettes descriptives s'affichent sur le formulaire. Les composants suivants apparaissent dans la barre d'état des composants :
- NorthwindDataSet. Le groupe de données typé qui contient les tables Customers et Orders.
- CustomersBindingSource. Le BindingSource qui lie les contrôles sur le formulaire à la table de données Customers dans NorthwindDataSet.
- CustomersBindingNavigator. Le BindingNavigator utilisé pour parcourir les enregistrements dans la table Customers.
- CustomersTableAdapter. Le TableAdapter qui communique entre la base de données et NorthwindDataSet. Pour plus d'informations, consultez Vue d'ensemble de TableAdapter.
- TableAdapterManager. Le composant TableAdapterManager utilisé pour contrôler l'ordre des insertions, des mises à jour et des suppressions pour tous les composants TableAdapter dans le groupe de données. Pour plus d'informations, consultez Vue d'ensemble de TableAdapterManager.

Création de contrôles permettant d'afficher des données de la table Orders

Pour créer des contrôles afin d'afficher les commandes de chaque client (enregistrements enfants)

Dans la fenêtre Sources de données, développez le nœud Customers et sélectionnez la dernière colonne de la table Customers, qui est un nœud Orders pouvant être développé sous la colonne Fax et faites-la glisser jusqu'au bas de Form1. (Dans la hiérarchie de la table Customers, ce nœud représente les commandes connexes d'un client, par opposition au nœud Orders principal qui représente tous les enregistrements de la table Orders et non ceux d'un client individuel.)

Un DataGridView est ajouté au formulaire, et un nouveau composant BindingSource (OrdersBindingSource) ainsi qu'un nouveau TableAdapter (OrdersTableAdapter) sont ajoutés à la barre d'état des composants.

Remarque :
Ouvrez la fenêtre Propriétés et sélectionnez le composant OrdersBindingSource. Examinez les propriétés DataSource et DataMember pour observer la manière dont la liaison de données est configurée pour afficher les enregistrements connexes. Le DataSource a la valeur CustomersBindingSource (BindingSource de la table parente), par opposition à la table Orders. La propriété DataMember a la valeur FK_Orders_Customers, qui est identique au nom de l'objet DataRelation reliant les tables.

Ouvrez la fenêtre Propriétés et sélectionnez le composant OrdersBindingSource. Examinez les propriétés DataSource et DataMember pour observer la manière dont la liaison de données est configurée pour afficher les enregistrements connexes. Le DataSource a la valeur CustomersBindingSource (BindingSource de la table parente), par opposition à la table Orders. La propriété DataMember a la valeur FK_Orders_Customers, qui est identique au nom de l'objet DataRelation reliant les tables.

Test de l'application

Pour tester l'application

Appuyez sur F5.
Sélectionnez différents clients pour vérifier que les commandes correctes sont affichées dans la grille sur le formulaire.
Modifiez un ou plusieurs enregistrements.
Cliquez sur le bouton Enregistrer (l'icône de disquette).
Vérifiez que les modifications ont été enregistrées dans la base de données.

Étapes suivantes

Selon les spécifications de votre application, vous pouvez exécuter différentes étapes après la création d'un formulaire maître/détail. Vous pouvez apporter à cette procédure pas à pas les améliorations suivantes :

Modification de la requête qui charge des données dans l'application à l'aide des Assistants TableAdapter. Pour plus d'informations, consultez Comment : modifier des requêtes TableAdapter et Comment : modifier des TableAdapters.
Ajout de la validation pour vérifier que les données correctes sont entrées avant d'envoyer des modifications à la base de données. Pour plus d'informations, consultez Validation des données.