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

BulletedListDisplayMode, énumération

Remarque : cette énumération est nouvelle dans le .NET Framework version 2.0.

Spécifie les comportements d'affichage que vous pouvez appliquer au contenu d'élément de liste dans un contrôle BulletedList.

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

public enum BulletedListDisplayMode
public enum BulletedListDisplayMode
public enum BulletedListDisplayMode

 Nom de membreDescription
HyperLinkAffiche le contenu de l'élément de liste sous la forme d'un lien hypertexte. 
LinkButtonAffiche le contenu de l'élément de liste sous la forme d'un bouton de lien. 
TextAffiche le contenu de l'élément de liste sous la forme de texte. 

L'énumération BulletedListDisplayMode représente les comportements d'affichage que vous pouvez appliquer au contenu des éléments de liste dans un contrôle BulletedList. La propriété DisplayMode utilise ces valeurs d'énumération pour définir le comportement d'affichage du contenu dans un contrôle BulletedList. Par exemple, si vous affectez la valeur HyperLink à la propriété DisplayMode, le contenu de chaque élément de liste dans le contrôle BulletedList est restitué sous forme de lien hypertexte.

La valeur Text vous permet d'afficher le contenu d'élément de liste sous la forme d'un texte normal sans fonctionnalité supplémentaire.

La valeur HyperLink vous permet d'afficher le contenu de l'élément de liste sous la forme d'un lien hypertexte. Si vous cliquez dessus, un lien hypertexte vous fera naviguer vers une URL. Utilisez la propriété Value pour spécifier l'URL à atteindre.

La valeur LinkButton vous permet d'afficher le contenu de l'élément de liste sous la forme d'un bouton de lien Utilisez l'événement BulletedList.Click pour publier sur le serveur lorsque l'utilisateur clique sur un bouton de lien. 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é.

L'exemple de code suivant illustre la création d'un contrôle BulletedList et la définition de la propriété DisplayMode. Un contrôle ListBox est rempli avec les valeurs BulletedListDisplayMode. Le format du contenu d'élément de liste change selon le mode d'affichage que l'utilisateur sélectionne dans la zone de liste.


<%@ Page Language="C#" %>

<html>
<head>

    <script runat="server">   	
        protected void Index_Changed(object sender, EventArgs e)
        {
            // Change the message displayed, based on 
            // the style selected from the list box.
            if (BulletStylesListBox.SelectedIndex > -1)
            {
                Message.Text = "You selected bullet style: " +
                    BulletStylesListBox.SelectedItem.Text;
            }

            // Change the bullet style used, based on 
            // the style selected from the list box.
            switch (BulletStylesListBox.SelectedIndex)
            {
                case 0:
                    ItemsBulletedList.BulletStyle = BulletStyle.Numbered;
                    break;
                case 1:
                    ItemsBulletedList.BulletStyle = BulletStyle.LowerAlpha;
                    break;
                case 2:
                    ItemsBulletedList.BulletStyle = BulletStyle.UpperAlpha;
                    break;
                case 3:
                    ItemsBulletedList.BulletStyle = BulletStyle.LowerRoman;
                    break;
                case 4:
                    ItemsBulletedList.BulletStyle = BulletStyle.UpperRoman;
                    break;
                case 5:
                    ItemsBulletedList.BulletStyle = BulletStyle.Disc;
                    break;
                case 6:
                    ItemsBulletedList.BulletStyle = BulletStyle.Circle;
                    break;
                case 7:
                    ItemsBulletedList.BulletStyle = BulletStyle.Square;
                    break;
                case 8:
                    ItemsBulletedList.BulletStyle = BulletStyle.CustomImage;
                    // Specify the path to the custom image to use for the bullet.
                    ItemsBulletedList.BulletImageUrl = "Images/image1.jpg";
                    break;
                case 9:
                    Message.Text = "You selected NotSet. The browser will determine the bullet style.";
                    break;
                default:
                    throw new Exception("You did not select a valid bullet style.");
            }

        }
</script>

</head>
<body>
    <form id="Form1" runat="server">
        <h3>
            BulletStyle Example</h3>
        <asp:BulletedList ID="ItemsBulletedList" DisplayMode="Text" BulletStyle="NotSet"
            runat="server">
            <asp:ListItem Value="0">Coho Winery</asp:ListItem>
            <asp:ListItem Value="1">Contoso, Ltd.</asp:ListItem>
            <asp:ListItem Value="2">Tailspin Toys</asp:ListItem>
        </asp:BulletedList>
        <hr>
        <h4>
            Select a bullet type:</h4>
        <asp:ListBox ID="BulletStylesListBox" SelectionMode="Single" Rows="1" OnSelectedIndexChanged="Index_Changed"
            AutoPostBack="True" runat="server">
            <asp:ListItem Value="Numbered">Numbered</asp:ListItem>
            <asp:ListItem Value="LowerAlpha">LowerAlpha</asp:ListItem>
            <asp:ListItem Value="UpperAlpha">UpperAlpha</asp:ListItem>
            <asp:ListItem Value="LowerRoman">LowerRoman</asp:ListItem>
            <asp:ListItem Value="UpperRoman">UpperRoman</asp:ListItem>
            <asp:ListItem>Disc</asp:ListItem>
            <asp:ListItem>Circle</asp:ListItem>
            <asp:ListItem>Square</asp:ListItem>
            <asp:ListItem>CustomImage</asp:ListItem>
            <asp:ListItem Value="NotSet">NotSet</asp:ListItem>
        </asp:ListBox>
        <hr>
        <asp:Label ID="Message" runat="server" />
    </form>
</body>
</html>

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: