Exporter (0) Imprimer
Développer tout
Cet article a fait l'objet d'une traduction manuelle. Déplacez votre pointeur sur les phrases de l'article pour voir la version originale de ce texte.
Traduction
Source

Vue d'ensemble du contrôle serveur Web BulletedList

Le contrôle BulletedList crée une liste d'éléments triés (numérotés) ou non triés, qui sont rendus sous forme d'éléments HTML ul ou ol, respectivement.

Cette rubrique contient les sections suivantes :

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

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

  • Définir les éléments de liste de manière statique ou en liant le contrôle aux données.

  • Répondre aux clics effectués par l'utilisateur sur les éléments.

Retour au début

Lorsque vous utilisez le contrôle BulletedList, vous pouvez effectuer les opérations suivantes :

  • Personnaliser l'apparence des puces et des nombres.

  • Spécifier la façon dont chaque élément de la liste est rendu, par exemple en tant que lien hypertexte, texte statique ou bouton de lien.

  • Fournir une logique d'exécution de tâches spécifiques à l'application lorsqu'un utilisateur clique sur un élément.

Retour au début

Le contrôle BulletedList dérive de la même classe ListControl que ListBox, DropDownList et les autres contrôles de liste ASP.NET. Par conséquent, l'utilisation du contrôle BulletedList est semblable à l'utilisation de 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 vous savez au moment du design quels éléments vous souhaitez afficher, vous pouvez affecter à la collection Items du contrôle un ensemble 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.

Vous pouvez également lier le contrôle à une source de données qui contient les informations que vous souhaitez afficher. Pour plus d'informations, consultez Comment : remplir des contrôles serveur Web List à partir d'une source de données.

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 lire la valeur directement.

Note de sécurité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.

RemarqueRemarque

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 configuré pour effectuer le rendu des nombres, vous pouvez sélectionner les options de numérotation standard HTML, par exemple 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 comme ce qui suit :

  • 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 accéder à une autre page. Vous devez fournir une URL cible en guise de propriété Value de chacun des éléments.

  • Contrôles LinkButton    Quel que soit l'élément individuel sur lequel les utilisateurs cliquent, le contrôle effectue 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 des contrôles serveur Web BulletedList.

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

Membre

Description

BulletedList

Classe principale du contrôle

BulletedListDisplayMode

Énumération qui spécifie le comportement d'affichage de chaque élément.

BulletedListEventArgs

Données d'événement qui indiquent l'index de l'élément sélectionné.

BulletedListEventHandler

Méthode qui gère l'événement Click d'un contrôle BulletedList.

BulletStyle

Énumération qui spécifie les types de puces, de nombres ou de lettres qui peuvent être affichés.

Retour au début

Ajouts de la communauté

AJOUTER
Afficher:
© 2014 Microsoft