Partager via


Procédure pas à pas : création d'une table de correspondance dans une application Windows Forms

Une table de correspondance est utilisée pour afficher les informations provenant d'une table selon la valeur d'un champ clé étrangère dans une autre table. Prenons l'exemple d'une table Orders dans une base de données des ventes. Chaque enregistrement contenu dans la table Orders comprend un CustomerID qui indique le client qui a passé la commande. Ce CustomerID est une clé étrangère qui désigne un enregistrement de client dans la table Customers. Lors de la présentation d'une liste de commandes (à partir de la table Orders), vous pouvez afficher le nom réel des clients plutôt que le CustomerID. Étant donné que le nom des clients se trouve dans la table Customers et que vous présentez des données provenant de la table Orders, vous devez créer une table de correspondance qui importe la valeur CustomerID dans l'enregistrement Orders et utilise cette valeur pour parcourir la relation et retourner le nom de client plus lisible. Ce concept est connu sous le nom de table de correspondance.

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

Composants requis

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

Création d'une nouvelle application Windows

Pour créer le nouveau projet Application Windows

  1. Dans le menu Fichier, créez un nouveau projet.

  2. Nommez le projet LookupTableWalkthrough.

  3. Sélectionnez Application Windows, puis cliquez sur OK. Pour plus d'informations, consultez Création d'applications Windows.

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

Création d'une nouvelle source de données

Pour créer la source de données

  1. Dans le menu Données, cliquez sur Afficher les sources de données.

  2. 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.

  3. Sélectionnez Base de données dans la page Choisir un type de source de données, puis cliquez sur Suivant.

  4. 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).

  5. 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.

  6. Cliquez sur Suivant dans la page Enregistrer la chaîne de connexion dans le fichier de configuration de l'application.

  7. Développez le nœud Tables dans la page Choisir vos objets de base de données.

  8. Sélectionnez les tables Customers et Orders, puis cliquez sur Terminer.

    NorthwindDataSet est ajouté à votre projet et les deux tables s'affichent dans la fenêtre Sources de données.

Création de contrôles liés aux données sur le formulaire

Pour créer des contrôles liés aux données sur le formulaire

  1. Développez le nœud Customers dans la fenêtre Sources de données.

  2. Remplacez le type de déplacement de la table Orders connexe par Détails en sélectionnant Détails dans la liste de contrôles du nœud Orders. 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.

  3. Développez le nœud Orders connexe et remplacez le type de déplacement de la colonne CustomerID par une zone de liste déroulante en sélectionnant ComboBox dans la liste déroulante du nœud CustomerID.

  4. Faites glisser le nœud Orders connexe depuis la fenêtre Sources de données jusqu'à Form1.

    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.

Création de la table de correspondance

Vous devez établir la table de correspondance en définissant des propriétés dans la zone de liste déroulante CustomerID :

Pour créer la fonctionnalité de table de correspondance sur le formulaire

  • Faites glisser directement le nœud Customers principal depuis la fenêtre Sources de données jusqu'à la zone de liste déroulante CustomerID de Form1.

    Notes

    Le tableau suivant est fourni à titre de référence uniquement ; les propriétés sont définies automatiquement au cours de la procédure de déplacement décrite ci-dessus. Le concepteur définit les propriétés suivantes comme décrit dans la section « Explication de la définition » ci-dessous. Selon les structures de votre table, il se peut que vous deviez ajuster les propriétés pour que la table de correspondance fonctionne correctement.

    Propriété

    Explication de la définition

    DataSource

    Visual Studio affecte à cette propriété la valeur BindingSource créée pour la table que vous faites glisser jusqu'au contrôle (et non la valeur BindingSource créée lors de la génération du contrôle).

    Si vous devez faire un réglage, affectez comme valeur à cette propriété le BindingSource de la table avec la colonne que vous souhaitez afficher. (CustomersBindingSource pour cette procédure pas à pas.)

    DisplayMember

    Visual Studio affecte à cette propriété la valeur de la première colonne après la clé primaire qui possède un type de données String pour la table que vous faites glisser jusqu'au contrôle.

    Si vous devez faire un réglage, affectez à cette propriété le nom de la colonne que vous souhaitez afficher.

    ValueMember

    Visual Studio affecte à cette propriété la valeur de la première colonne participant à la clé primaire, ou la première colonne de la table si aucune clé n'est définie.

    Si vous devez faire un réglage, affectez comme valeur à cette propriété la clé primaire de la table avec la colonne que vous souhaitez afficher.

    SelectedValue

    Visual Studio affecte comme valeur à cette propriété la colonne d'origine déplacée depuis la fenêtre Sources de données.

    Si vous devez faire un réglage, affectez comme valeur à cette propriété la colonne de clé étrangère contenue dans la table connexe. (CustomerID dans la table Orders pour cette procédure pas à pas.)

Exécution de l'application

Pour exécuter l'application

  1. Appuyez sur F5.

  2. Parcourez les commandes et vérifiez que la zone de liste déroulante CustomerID affiche le CompanyName de chaque commande de la table Customers (et non la colonne CustomerID de la table Orders).

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

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

Liaison de contrôles à des données dans Visual Studio

Autres ressources

Procédures pas à pas relatives aux données

Connexion aux données dans Visual Studio

Préparation de votre application pour recevoir des données

Extraction de données dans votre application

Modification des données dans votre application

Validation des données

Enregistrement des données