Vue d'ensemble du contrôle serveur Web BulletedList

Mise à jour : novembre 2007

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 d'élément HTML ul ou ol.

Cette rubrique contient les sections suivantes :

• Scénarios

• Fonctionnalités

• Contexte

• Rubriques comment et procédure pas à pas

• Référence de classe

Scénarios

Utilisez le contrôle BulletedList pour effectuer les opérations suivantes :

• Spécifier l'apparence des éléments et des puces ou nombres d'une liste.

• Définir les éléments de liste de façon statique ou en liant le contrôle aux données.

• Répondre aux clics d'utilisateur sur les éléments.

Retour au début

Fonctionnalités

En utilisant le contrôle BulletedList vous pouvez effectuer les opérations suivantes:

• Personnalise l'apparence des puces et nombres.

• Spécifie comment chaque élément dans la liste est restitué, tel qu'un lien hypertexte, texte statique, ou comme un bouton de liaison.

• Fournit la logique pour effectuer des tâches spécifiques à l'application lorsqu'un utilisateur clique sur un élément.

Retour au début

Contexte

Le contrôle BulletedList dérive de la même classe ListControl que le ListBox, DropDownListet d'autres contrôles liste ASP.NET. Par conséquent, utiliser BulletedList est comme utiliser ces contrôles. 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. Si, au moment du design, vous connaissez les éléments que vous souhaitez afficher, vous pouvez affecter à la collection Items du contrôle un jeu d'éléments individuels dans le balisage. Si les éléments à afficher sont dynamiques, vous pouvez créer la collection d'éléments dans le code au moment de l'exécution. Pour plus d'informations, consultez Comment : ajouter des éléments dans des contrôles serveur Web List (Visual Studio).

Ou bien, vous pouvez lier le contrôle à une source de données qui contient les informations que vous désirez afficher. Pour plus d'informations, consultez Comment : remplir des contrôles serveur Web List à partir d'une source de données (Visual Studio).

Vous pouvez combiner des éléments de liste statiques et liés aux données en affectant la valeur true à la propriété AppendDataBoundItems.

Lorsque vous définissez des éléments pour le contrôle BulletedList, vous définissez deux propriétés : Text et Value. 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 directement lire la valeur.

Note de sécurité :
N'utilisez pas de données sensibles, telles que des numéros de client, comme propriété d'un contrôle BulletedList. Bien que ce ne soit pas visible, les paramètres de 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

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 restituer 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 Disc, Circle et Square.

Remarque :
Le mode de restitution 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 défini de manière à restituer des nombres, vous pouvez également sélectionner des options de numérotation HTML standard, telles que les champs LowerAlpha, UpperAlpha, LowerRoman et UpperAlpha. En définissant la propriété FirstBulletNumber, vous pouvez spécifier aussi le numéro de départ 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 T:System.Web.UI.WebControls.HyperLink   Les utilisateurs peuvent cliquer sur des liens pour se déplacer vers une autre page. Vous devez fournir une URL cible en guise de propriété Value de chacun des éléments.

• LinkButtoncontrôles   Les utilisateurs peuvent cliquer sur des éléments individuels et le contrôle exécute une publication (postback).

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

Si le contrôle BulletedList est configuré pour afficher des éléments individuels comme contrôles LinkButton, le contrôle effectue une publication lorsqu'un utilisateur clique sur un élément. Cette publication déclenche l'événement Click du contrôle BulletedList, au cours duquel vous pouvez fournir la logique permettant d'exécuter des tâches spécifiques à l'application. L'événement vous transmet le numéro d'index de l'élément sur lequel l'utilisateur a cliqué. Pour plus d'informations, consultez Comment : répondre aux clics d'utilisateur dans les contrôles serveur Web BulletedList (Visual Studio).

Rubriques comment et procédure pas à pas

• Comment : ajouter des contrôles serveur Web BulletedList à une page Web Forms (Visual Studio)

• Comment : répondre aux clics d'utilisateur dans les contrôles serveur Web BulletedList (Visual Studio)

Référence de classe

Le tableau suivant répertorie les classes relatives au contrôle BulletedList.

Retour au début

Voir aussi

Tâches

Comment : ajouter des éléments dans des contrôles serveur Web List (Visual Studio)

Comment : remplir des contrôles serveur Web List à partir d'une source de données (Visual Studio)

Comment : définir la sélection dans un contrôle serveur Web List (Visual Studio)