Ajoutez des contrôles personnalisés à la fenêtre Sources de données pour les applications .NET Framework

Remarque

Les jeux de données et les classes associées sont des technologies .NET Framework héritées qui datent du début des années 2000. Elles permettent aux applications d’utiliser des données en mémoire pendant que les applications sont déconnectées de la base de données. Elles sont particulièrement utiles aux applications qui permettent aux utilisateurs de modifier des données, et de rendre ces changements persistants dans la base de données. Même si les jeux de données sont une technologie très efficace, nous vous recommandons d’utiliser Entity Framework Core pour les nouvelles applications .NET. Entity Framework offre un moyen plus naturel d’utiliser des données tabulaires en tant que modèles objet. De plus, il présente une interface de programmation plus simple.

Lorsque vous faites glisser un élément de la fenêtre Sources de données vers une aire de conception pour créer un contrôle lié aux données, vous pouvez sélectionner le type de contrôle que vous créez. Chaque élément de la fenêtre a une liste déroulante qui affiche les contrôles que vous pouvez choisir. L’ensemble de contrôles associés à chaque élément est déterminé par le type de données de l’élément. Si le contrôle que vous souhaitez créer n’apparaît pas dans la liste, vous pouvez suivre les instructions de cette rubrique pour ajouter le contrôle à la liste.

Pour plus d’informations sur la sélection de contrôles liés aux données à créer pour les éléments de la fenêtre Sources de données, consultez Définir le contrôle à créer lorsque vous faites glisser à partir de la fenêtre Sources de données.

Personnaliser la liste des contrôles pouvant être liés

Pour ajouter ou supprimer des contrôles de la liste des contrôles disponibles pour les éléments de la fenêtre Sources de données qui ont un type de données spécifique, effectuez les étapes suivantes.

Pour sélectionner les contrôles à répertorier pour un type de données

  1. Vérifiez que le concepteur WPF ou le concepteur Windows Forms est ouvert.

  2. Dans la fenêtre Sources de données, cliquez sur un élément qui fait partie d'une source de données que vous avez ajoutée à la fenêtre, puis cliquez sur le menu de la liste déroulante de l'élément.

    Conseil

    Si la fenêtre Sources de données n’est pas ouverte, ouvrez-la en sélectionnant Afficher>Autres fenêtres>Sources de données.

  3. Dans le menu de la liste déroulante, cliquez sur Personnaliser. L’une des boîtes de dialogue suivantes s’ouvre :

  4. Dans la boîte de dialogue, sélectionnez un type de données dans la liste déroulante Type de données.

    • Pour personnaliser la liste des contrôles d’une table ou d’un objet, sélectionnez [Liste].

    • Pour personnaliser la liste des contrôles d’une colonne d’une table ou d’une propriété d’un objet, sélectionnez le type de données de la colonne ou de la propriété dans le magasin de données sous-jacent.

    • Pour personnaliser la liste des contrôles afin d’afficher des objets de données qui ont des formes définies par l’utilisateur, sélectionnez [Autre] . Par exemple, sélectionnez [Autre] si votre application dispose d’un contrôle personnalisé qui affiche les données de plusieurs propriétés d’un objet particulier.

  5. Dans la zone Contrôles associés, sélectionnez chaque contrôle que vous souhaitez mettre à disposition pour le type de données sélectionné, ou désactivez la sélection des contrôles que vous souhaitez supprimer de la liste.

    Notes

    Si le contrôle que vous souhaitez sélectionner n’apparaît pas dans la zone Contrôles associés, vous devez ajouter le contrôle à la liste. Pour plus d’informations, consultez Ajouter des contrôles associés.

  6. Cliquez sur OK.

  7. Dans la fenêtre Sources de données, cliquez sur un élément du type de données que vous venez d'associer à un ou plusieurs contrôles, puis cliquez sur le menu de la liste déroulante de l'élément.

    Les contrôles que vous avez sélectionnés dans la zone Contrôles associés s'affichent maintenant dans le menu de la liste déroulante de l'élément.

Ajouter des contrôles associés

Si vous souhaitez associer un contrôle à un type de données, mais que le contrôle n’apparaît pas dans la zone Contrôles associés, vous devez ajouter le contrôle à la liste. Le contrôle doit se trouver dans la solution actuelle ou dans un assembly référencé. Il doit également être disponible dans la Boîte à outils et avoir un attribut qui spécifie le comportement de liaison des données du contrôle.

Pour ajouter des contrôles à la liste des contrôles associés :

  1. Ajoutez le contrôle souhaité à la Boîte à outils en cliquant avec le bouton droit sur la Boîte à outils et en sélectionnant Choisir des éléments.

    Le contrôle doit avoir l’un des attributs suivants :

    Attribut Description
    DefaultBindingPropertyAttribute Implémentez cet attribut sur des contrôles simples qui affichent une seule colonne (ou propriété) de données, tel que TextBox.
    ComplexBindingPropertiesAttribute Implémentez cet attribut sur les contrôles qui affichent des listes (ou des tables) de données, tel que DataGridView.
    LookupBindingPropertiesAttribute Implémentez cet attribut sur des contrôles qui affichent des listes (ou tables) de données, mais doivent également présenter une seule colonne ou propriété, tel que ComboBox.
  2. Pour Windows Forms, dans la boîte de dialogue Options, ouvrez la page Personnalisation de l’interface utilisateur des données. Ou, pour WPF, ouvrez la boîte de dialogue Personnaliser la liaison de contrôle. Pour plus d’informations, consultez Personnaliser la liste des contrôles pouvant être liés pour un type de données.

  3. Dans la zone Contrôles associés, le contrôle que vous venez d’ajouter à la Boîte à outils devrait maintenant apparaître.

    Notes

    Seuls les contrôles qui se trouvent dans la solution actuelle ou dans un assembly référencé peuvent être ajoutés à la liste des contrôles associés. (Les contrôles doivent également implémenter l’un des attributs de liaison de données dans le tableau précédent.) Pour lier des données à un contrôle personnalisé qui n’est pas disponible dans la fenêtre Sources de données, faites glisser le contrôle de la Boîte à outils sur l’aire de conception, puis faites glisser l’élément à lier à partir de la fenêtre Sources de données sur le contrôle.