BulletedList, contrôle

Article
10/11/2017

Le contrôle BulletedList crée une liste d'éléments ordonnée (numérotée) ou non ordonnée, respectivement restituée sous forme de balise HTML <UL> ou <OL>. Vous pouvez spécifier l'aspect des éléments et des puces ou numéros, définir les éléments de liste de façon statique ou en liant le contrôle aux données, et répondre aux clics des utilisateurs sur les éléments.

Pour ajouter un contrôle BulletedList à une page

Faites glisser le contrôle BulletedList du volet des tâches Boîte à outils sur votre page.

Pour lier le contrôle BulletedList à une source de données

En mode Création, cliquez avec le bouton droit sur le contrôle BulletedList, puis cliquez sur Afficher les tâches de contrôle courantes.

Conseil :
Vous pouvez également cliquer sur le contrôle BulletedList en mode Création, puis cliquer sur la flèche dans le coin supérieur droit pour afficher le menu Tâches courantes du contrôle BulletedList. Cliquez de nouveau sur la flèche pour masquer le menu.

Dans le menu Tâches courantes du contrôle BulletedList, cliquez sur Choisir une source de données.
Dans l’Assistant Configuration de la source de données, choisissez une source pour le contrôle BulletedList dans la liste déroulante Sélectionner une source de données. Dans la liste déroulante Sélectionner un champ de données à afficher dans BulletedList, sélectionnez le champ pour le texte que l'utilisateur verra. Dans la liste déroulante Sélectionner un champ de données pour la valeur de BulletedList, sélectionnez le champ des données qui peut être accessible par programmation lorsque l'utilisateur choisit un élément dans la liste.

Définition d'éléments de liste

Vous pouvez définir des éléments de liste pour le contrôle BulletedList en créant des éléments statiques ou en liant le contrôle à une source de données. Vous pouvez combiner des éléments de liste statiques et liés aux données en affectant la valeur vrai à la propriété du contrôle AppendDataBoundItems.

Lorsque vous définissez des éléments pour le contrôle BulletedList, vous définissez deux propriétés : la propriété Text (Texte) et la propriété Value (Valeur). La propriété Text définit ce que le contrôle affiche sur la page. La propriété Value définit une deuxième valeur qui n'est pas affichée mais que vous pouvez renvoyer lorsqu'un utilisateur sélectionne un élément. Par exemple, vous pouvez afficher un nom d'employé comme texte d'un élément, mais utiliser l'ID d'employé comme valeur ; lorsque les utilisateurs cliquent sur l'élément, vous pouvez lire la valeur directement.

Pour définir des éléments pour le contrôle BulletedList

En mode Création, cliquez avec le bouton droit sur le contrôle BulletedList, puis cliquez sur Afficher les tâches de contrôle courantes.
Dans le menu Tâches courantes du contrôle BulletedList, cliquez sur Modifier les éléments.
Dans la boîte de dialogue Éditeur de collections ListItem, cliquez sur Ajouter pour ajouter un élément.
Dans la zone des propriétés ListItem, définissez les propriétés Text (Texte) et Value (Valeur).

Répétez les étapes 3 à 4 jusqu'à ce que vous ayez ajouté tous les éléments souhaités.

Remarque :
N'utilisez pas de données sensibles, telles que des numéros de client, comme propriété de Value d'un contrôle BulletedList. Bien qu'ils ne soient pas visibles, les paramètres de la propriété Value d'éléments individuels sont restitués sur la page, où les utilisateurs peuvent les lire facilement dans le code source.

Personnalisation de l'aspect d'un élément de liste

Vous pouvez spécifier davantage d'options d'affichage pour le contrôle BulletedList dans le volet des tâches Propriétés des balises.

Pour utiliser le volet des tâches Propriétés des balises afin de définir les propriétés de BulletedList

Cliquez avec le bouton droit sur le contrôle BulletedList en mode Création et cliquez sur Propriétés dans le menu contextuel.
Entrez les valeurs de la propriété ou sélectionnez-les dans les listes déroulantes où elles sont disponibles.

Le contrôle BulletedList peut restituer des puces ou des numéros, en fonction de la valeur de la propriété BulletStyle. Si le contrôle est configuré pour afficher des puces, vous pouvez sélectionner des champs de style de puce prédéfinis qui correspondent aux styles de puce HTML standard, tels que ceux qui sont représentés par les champs Disc, Circle et Square.

Remarque :
Le mode de rendu des puces varie pour chaque navigateur, certains ne prenant pas en charge certains styles de puce, tels que le champ Disc.

Vous pouvez également spécifier une image personnalisée qui sera affichée à la place de la puce.

Si le contrôle est configuré pour restituer des numéros, vous pouvez également sélectionner des options de numérotation HTML standard, telles que les champs LowerAlpha, LowerRoman et UpperAlpha. En définissant la propriété FirstBulletNumber, vous pouvez spécifier aussi le numéro de début de la séquence.

Spécification du mode d'affichage des éléments

Le contrôle BulletedList peut afficher les éléments de liste sous les formes suivantes :

Texte statique : Le texte affiché par le contrôle n'est pas interactif.
Contrôles HyperLink : Les utilisateurs peuvent cliquer sur les liens pour naviguer d'une page à une autre. Vous devez fournir une URL cible en guise de propriété Valeur de chacun des éléments.
Contrôles LinkButton : Les utilisateurs peuvent cliquer sur des éléments individuels et le contrôle exécute une publication.

Remarque :
Si vous avez affecté la valeur HyperLink à la propriété DisplayMode, spécifiez les URL cibles des liens hypertexte dans la propriété Value (Valeur) de chaque élément.

Définissez la propriété BulletStyle pour spécifier si le contrôle affiche les éléments en tant que puces ou en tant que numéros. Pour créer une liste numérotée ou triée, affectez l'une des valeurs d'énumération suivantes à la propriété BulletStyle :

Numbered
LowerAlpha
UpperAlpha
LowerRoman
LowerRoman

Pour créer une liste à puces, c'est-à-dire non triée, affectez l'une des valeurs d'énumération suivantes à la propriété BulletStyle :

Disc
Circle
Square

Pour afficher les puces sous forme d'images personnalisées, affectez à la propriété BulletStyle l'URL d'une image. La même image s'affiche pour chaque élément.

Réponse à la sélection de l'utilisateur

Pour plus d’informations sur la réponse à la sélection d’éléments de l’utilisateur dans votre contrôle BulletedList, voir Comment : Répondre aux clics d’utilisateur dans, dans MSDN Library.

Pour une description complète de toutes les propriétés du contrôle BulletedList, voir BulletedList dans MSDN Library.