BulletedList, contrôle

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 panneau Boîte à outils sur votre page.

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

1. 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 Login. Cliquez de nouveau sur la flèche pour masquer le menu.

2. Dans le menu Tâches courantes du contrôle BulletedList, cliquez sur Choisir une source de données.

3. 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 et la propriété 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.

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

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

2. Dans le menu Tâches courantes du contrôle BulletedList, cliquez sur Modifier les éléments.

3. Dans la boîte de dialogue Éditeur de collections ListItem, cliquez sur Ajouter pour ajouter un élément.

4. Dans la zone des propriétés ListItem, définissez les propriétés Text et Value .

5. 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, pour la propriété 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 panneau Propriétés de la balise.

Pour utiliser le panneau Propriétés de la balise afin de définir les propriétés BulletedList

1. Cliquez avec le bouton droit sur le contrôle BulletedList en mode Création et choisissez Propriétés dans le menu contextuel.

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

• HyperLink Les utilisateurs peuvent cliquer sur les liens pour naviguer d’une page à une autre. Vous devez fournir une URL comme propriété Value pour chacun des éléments.

• LinkButton Les utilisateurs peuvent cliquer sur des éléments individuels et le contrôle exécute une publication.

Remarque :
Si vous avez défini la propriété DisplayMode avec la valeur HyperLink , spécifiez les URL cibles des liens hypertexte dans la propriété Value 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 ordonné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 ordonnée, affectez l’une des valeurs 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 des contrôles serveur Web BulletedList  dans MSDN Library.

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

Voir aussi

Concepts

Utilisation de sites ASP.NET
contrôles de données ASP.NET
contrôles de validation ASP.NET
contrôles de navigation ASP.NET
contrôles d’ouverture de session ASP.NET
contrôles des composants WebPart ASP.NET

Autres ressources

contrôles standard ASP.NET