Cette documentation est archivée et n’est pas conservée.

BulletedList, classe

Remarque : cette classe est nouvelle dans le .NET Framework version 2.0.

Crée un contrôle qui génère une liste d'éléments dans un format à puces.

Espace de noms : System.Web.UI.WebControls
Assembly : System.Web (dans system.web.dll)

public class BulletedList : ListControl, IPostBackEventHandler
public class BulletedList extends ListControl implements IPostBackEventHandler
public class BulletedList extends ListControl implements IPostBackEventHandler

Utilisez le contrôle BulletedList pour créer une liste des éléments mis en forme avec des puces. Pour spécifier les éléments de liste individuels que vous souhaitez afficher dans un contrôle BulletedList, placez un objet ListItem, pour chaque entrée, entre les balises d'ouverture et de fermeture du contrôle BulletedList.

Pour spécifier le type de puce à utiliser pour afficher les éléments de liste dans un contrôle BulletedList, définissez la propriété BulletStyle comme un des types de puce définis par l'énumération BulletStyle. Le tableau suivant répertorie les styles de puce disponibles.

Style de puce

Description

NotSet

Non défini.

Numbered

Nombre.

LowerAlpha

Lettre minuscule.

UpperAlpha

Lettre majuscule.

LowerRoman

Chiffre romain minuscule.

UpperRoman

Chiffre romain majuscule.

Disc

Cercle plein.

Circle

Cercle vide.

Square

Carré plein.

CustomImage

Image personnalisée.

Utilisez la propriété FirstBulletNumber pour spécifier la valeur qui démarre la numérotation des éléments de liste dans un contrôle BulletedList ordonné. La valeur assignée à la propriété FirstBulletNumber est ignorée si la propriété BulletStyle a la valeur du champ Disc, Square, Circle ou CustomImage. Si vous affectez la valeur de CustomImage à la propriété BulletStyle pour spécifier une image personnalisée pour la puce, vous devez également définir la propriété BulletImageUrl pour spécifier l'emplacement du fichier image.

Pour spécifier le comportement d'affichage des éléments de liste dans un BulletedList, affectez à la propriété DisplayMode l'une des valeurs définies par l'énumération BulletedListDisplayMode. Les comportements d'affichage définis sont Text, HyperLink et LinkButton.

Si vous cliquez sur un lien hypertexte, il vous fera naviguer vers une URL. Utilisez la propriété Value pour spécifier l'URL à atteindre. Utilisez la propriété Target pour spécifier le frame ou la fenêtre qui affiche la page Web cible lorsqu'un clic a été effectué sur un lien hypertexte.

Lorsque la propriété DisplayMode a la valeur LinkButton, le contrôle BulletedList affiche des éléments de liste comme des liens qui publient sur le serveur lorsqu'un clic est effectué dessus. Pour contrôler par programme les actions effectuées lorsqu'un clic est effectué sur un bouton, fournissez un gestionnaire d'événements pour l'événement Click. Notez que les propriétés SelectedIndex et SelectedItem sont héritées de la classe ListControl et ne sont pas applicables au contrôle BulletedList. Utilisez les données d'événement de la classe BulletedListEventArgs pour déterminer l'index du bouton de lien d'un BulletedList sur lequel l'utilisateur a cliqué.

Le contrôle BulletedList prend également en charge la liaison de données. Pour lier BulletedList à une source de données, vous pouvez utiliser n'importe quel mécanisme de liaison de données fourni. Pour plus d'informations, consultez Liaison à des bases de données.

Accessibilité

Le balisage rendu par défaut pour ce contrôle peut ne pas se conformer aux normes d'accessibilité telles que les instructions de priorité 1 d'accessibilité du contenu Web (WCAG, Web Content Accessibility Guidelines). Pour plus d'informations sur la prise en charge d'accessibilité pour ce contrôle, consultez Contrôles et accessibilité ASP.NET.

RubriqueEmplacement
Comment : remplir des contrôles serveur Web List à partir d'une source de données (Visual Studio)Génération d'applications Web ASP.NET dans Visual Studio
Comment : ajouter des éléments dans des contrôles serveur Web List (Visual Studio)Génération d'applications Web ASP.NET dans Visual Studio
Comment : répondre aux clics d'utilisateur dans les contrôles serveur Web BulletedList (Visual Studio)Génération d'applications Web ASP.NET dans Visual Studio
Comment : ajouter des contrôles serveur Web BulletedList à une page Web Forms (Visual Studio)Génération d'applications Web ASP.NET dans Visual Studio
Comment : répondre aux clics d'utilisateur dans les contrôles serveur Web BulletedList (Visual Studio)Génération d'applications Web ASP.NET dans Visual Studio
Comment : remplir des contrôles serveur Web List à partir d'une source de données (Visual Studio)Génération d'applications Web ASP.NET dans Visual Studio
Comment : ajouter des éléments dans des contrôles serveur Web List (Visual Studio)Génération d'applications Web ASP.NET dans Visual Studio
Comment : ajouter des contrôles serveur Web BulletedList à une page Web Forms (Visual Studio)Génération d'applications Web ASP.NET dans Visual Studio
Comment : ajouter des contrôles serveur Web BulletedList à une page Web FormsGénération d'applications Web ASP.NET
Comment : répondre aux clics d'utilisateur dans des contrôles serveur Web BulletedListGénération d'applications Web ASP.NET
Comment : ajouter des éléments dans des contrôles serveur Web ListGénération d'applications Web ASP.NET
Comment : remplir des contrôles serveur Web List à partir d'une source de donnéesGénération d'applications Web ASP.NET
Comment : répondre aux clics d'utilisateur dans les contrôles serveur Web BulletedList (Visual Studio)Génération d'applications Web ASP.NET dans Visual Studio
Comment : remplir des contrôles serveur Web List à partir d'une source de données (Visual Studio)Génération d'applications Web ASP.NET dans Visual Studio
Comment : ajouter des éléments dans des contrôles serveur Web List (Visual Studio)Génération d'applications Web ASP.NET dans Visual Studio
Comment : ajouter des contrôles serveur Web BulletedList à une page Web Forms (Visual Studio)Génération d'applications Web ASP.NET dans Visual Studio

Cette section comprend deux exemples de code. Le premier exemple de code illustre la création d'un contrôle BulletedList avec les éléments de liste mis en forme comme des boutons de lien. Le deuxième exemple de code illustre la création d'un contrôle BulletedList à l'aide de la liaison de données pour spécifier les éléments de liste.

L'exemple de code suivant illustre la création d'un contrôle BulletedList avec les éléments de liste mis en forme comme des boutons de lien. Le texte est affiché dans un contrôle Label lorsqu'un clic est effectué sur un élément de liste.

<%@ Page Language="VB" %>

<html>
<head>
    <script runat="server">

    Sub ItemsBulletedList_Click(ByVal sender As Object, ByVal e As System.Web.UI.WebControls.BulletedListEventArgs)
        ' Change the message displayed in the label based on the index
        ' of the list item that was clicked.
        Select Case (e.Index)
            Case 0
               Message.Text = "You clicked list item 1."
            Case 1
               Message.Text = "You clicked list item 2."
            Case 2
               Message.Text = "You clicked list item 3."
            Case 3
               Message.Text = "You clicked list item 4."
            Case Else
               Throw New Exception("You did not click a valid list item.")
        End Select

    End Sub

    </script>

</head>
<body>

    <h3>BulletedList Class Example</h3>

    <form runat="server">
			
        <h4>Click on an item in the list.</h4>        
        <asp:BulletedList id="ItemsBulletedList" 
            BulletStyle="Disc"
	    DisplayMode="LinkButton" 
	    OnClick="ItemsBulletedList_Click"
	    runat="server">    
		<asp:ListItem Value="http://www.cohowinery.com">Coho Winery</asp:ListItem>
		<asp:ListItem Value="http://www.contoso.com">Contoso, Ltd.</asp:ListItem>
		<asp:ListItem Value="http://www.tailspintoys.com">Tailspin Toys</asp:ListItem>
        </asp:BulletedList>
				
	<asp:Label id="Message" 
	    Font-Size="12"
            Font-Bold="True"
	    Width="168px" 
	    runat="server"/>
              
   </form>

</body>
</html>

L'exemple de code illustre la création d'un contrôle BulletedList à l'aide de la liaison de données pour spécifier les éléments de liste. Les éléments de liste sont mis en forme comme des boutons de lien. Le texte est affiché dans un contrôle Label lorsqu'un clic est effectué sur un élément de liste.

<%@ Page Language="VB" %>

<html>
<head>

    <script runat="server">

        Sub ProductsBulletedList_Click(ByVal sender As Object, ByVal e As System.Web.UI.WebControls.BulletedListEventArgs)
            ' Change the message displayed in the label based on the index
            ' of the list item that was clicked.
            Select Case (e.Index)
                Case 0
                    Message.Text = "Product 1 was clicked"
                Case 1
                    Message.Text = "Product 2 was clicked"
                Case 2
                    Message.Text = "Product 3 was clicked"
                Case 3
                    Message.Text = "Product 4 was clicked"
                Case Else
                    Throw New Exception("You must click a valid list item.")
            End Select

        End Sub

    </script>
    
</head>
<body>

    <h3>BulletedList Class Data Binding Example</h3>

    <form ID="Form1" runat="server">
			
        <P>Click on an item in the list.</p>			
        <P>
        <asp:BulletedList id="ProductsBulletedList" 
            BulletStyle="Disc"
	    DisplayMode="LinkButton" 
	    DataTextField="ProductName"
	    DataSourceID="SqlDataSource1"
	    OnClick="ProductsBulletedList_Click"
	    runat="server">    				
	</asp:BulletedList></P>
		
	<P>
	<asp:SqlDataSource id="SqlDataSource1" 		 
            ConnectionString="<%$ ConnectionStrings:NorthWindConnection%>"
            runat="server"
            SelectCommand="SELECT * FROM [Products] Where ProductID < 5">
        </asp:SqlDataSource></P>
		
	<P>		
	<asp:Label id="Message" 
	    Font-Size="12"
	    Width="168px" 
	    Font-Bold="True" 
	    runat="server"/>                
              
   </form>

</body>
</html>

  • AspNetHostingPermission  pour opérer dans un environnement hébergé. Valeur de demande : LinkDemand ; valeur d'autorisation : Minimal
  • AspNetHostingPermission  pour opérer dans un environnement hébergé. Valeur de demande : InheritanceDemand ; valeur d'autorisation : Minimal

Les membres statiques publics (Shared en Visual Basic) de ce type sont thread-safe. Il n'est pas garanti que les membres d'instance soient thread-safe.

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Édition Media Center, Windows XP Professionnel Édition x64, Windows XP SP2, Windows XP Starter Edition

Le .NET Framework ne prend pas en charge toutes les versions de chaque plate-forme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise.

.NET Framework

Prise en charge dans : 2.0
Afficher: