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

BulletStyle, énumération

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

Spécifie les styles de puce que vous pouvez appliquer aux éléments de liste dans un contrôle BulletedList.

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

public enum BulletStyle
public enum BulletStyle
public enum BulletStyle

 Nom de membreDescription
CircleLe style de puce est en forme de cercle vide. 
CustomImageLe style de puce est une image personnalisée. 
DiscLe style de puce est en forme de cercle plein. 
LowerAlphaLe style de puce est une lettre minuscule (a, b, c, ...). 
LowerRomanLe style de puce est un chiffre romain minuscule (i, ii, iii, ...). 
NotSetLe style de puce n'est pas défini. Le navigateur qui restitue le contrôle BulletedList déterminera le style de puce à afficher. 
NumberedLe style de puce est un nombre (1, 2, 3, ...). 
SquareLe style de puce est en forme de carré plein. 
UpperAlphaLe style de puce est une lettre majuscule (A, B, C, ...). 
UpperRomanLe style de puce est un chiffre romain majuscule (I, II, III, ...). 

L'énumération BulletStyle représente les styles de puce que vous pouvez appliquer aux éléments de liste dans un contrôle BulletedList. La propriété BulletStyle utilise ces valeurs d'énumération pour définir les styles de puce dans un contrôle BulletedList. Par exemple, si vous définissez la propriété BulletStyle sur Disc, chaque élément de liste dans un contrôle BulletedList restituera un cercle plein précédant le contenu de l'élément de liste comme suit :

  • Élément de liste 1

  • Élément de liste 2

  • Élément de liste 3

La spécification du style de puce CustomImage vous permet de fournir votre propre image pour la puce. Si vous spécifiez le style de puce CustomImage, vous devez également définir la propriété BulletImageUrl sur l'URL de l'image personnalisée à utiliser.

Si vous spécifiez NotSet, le navigateur dans lequel le contrôle est restitué déterminera le style de puce à afficher avec les éléments de liste dans le contrôle BulletedList.

RubriqueEmplacement
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 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 Forms (Visual Studio)Génération d'applications Web ASP.NET dans Visual Studio

L'exemple suivant illustre la création d'un contrôle BulletedList. Un contrôle ListBox est rempli avec toutes les valeurs d'énumération BulletStyle disponibles. Le style de puce change selon le style 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: