Erweitern Minimieren
Dieser Artikel wurde noch nicht bewertet - Dieses Thema bewerten.

BulletStyle-Enumeration

Hinweis: Diese Enumeration ist neu in .NET Framework, Version 2.0.

Gibt den Aufzählungssymbolstil an, den Sie in einem BulletedList-Steuerelement auf Listenelemente anwenden können.

Namespace: System.Web.UI.WebControls
Assembly: System.Web (in system.web.dll)

public enum BulletStyle
public enum BulletStyle
public enum BulletStyle
 MembernameBeschreibung
CircleDer Aufzählungssymbolstil ist ein leerer Kreis. 
CustomImageDer Aufzählungssymbolstil ist ein benutzerdefiniertes Bild. 
DiscDer Aufzählungssymbolstil ist ein ausgefüllter Kreis. 
LowerAlphaDer Aufzählungssymbolstil ist ein kleingeschriebener Buchstabe (a, b, c, ...). 
LowerRomanDer Aufzählungssymbolstil ist eine kleingeschriebene römische Ziffer (i, ii, iii, ...). 
NotSetDer Aufzählungssymbolstil ist nicht festgelegt. Der anzuzeigende Aufzählungssymbolstil wird durch den Browser bestimmt, der das BulletedList-Steuerelement rendert. 
NumberedDer Aufzählungssymbolstil ist eine Zahl (1, 2, 3, ...). 
SquareDer Aufzählungssymbolstil ist ein ausgefülltes Quadrat. 
UpperAlphaDer Aufzählungssymbolstil ist ein großgeschriebener Buchstabe (A, B, C, ...). 
UpperRomanDer Aufzählungssymbolstil ist eine großgeschriebene römische Ziffer (I, II, III, ...). 

Die BulletStyle-Enumeration stellt die Aufzählungssymbolstile dar, die Sie in einem BulletedList-Steuerelement auf Listenelemente anwenden können. Die BulletStyle-Eigenschaft verwendet diese Enumerationswerte, um in einem BulletedList-Steuerelement die Aufzählungssymbolstile festzulegen. Wenn Sie beispielsweise die BulletStyle-Eigenschaft auf Disc festlegen, wird jedes Listenelement in einem BulletedList-Steuerelement einen gefüllten Kreis rendern, der vor dem Inhalt des Listenelements wie folgt angezeigt wird:

  • Listenelement 1

  • Listenelement 2

  • Listenelement 3

Durch die Angabe des CustomImage-Aufzählungssymbolstils können Sie für das Aufzählungssymbol ein eigenes Bild bereitstellen. Wenn Sie den CustomImage-Aufzählungssymbolstil angeben, müssen Sie außerdem die BulletImageUrl-Eigenschaft auf den URL des zu verwendenden benutzerdefinierten Bildes festlegen.

Wenn Sie NotSet angeben, bestimmt der Browser, in dem das Steuerelement gerendert wird, den mit den Listenelementen im BulletedList-Steuerelement anzuzeigenden Aufzählungssymbolstil.

Das folgende Beispiel veranschaulicht das Erstellen eines BulletedList-Steuerelements. Ein ListBox-Steuerelement wird mit allen verfügbaren BulletStyle-Enumerationswerten aufgefüllt. Der Aufzählungssymbolstil ändert sich entsprechend der Auswahl, die der Benutzer im Listenfeld vornimmt.


<%@ 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 Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

.NET Framework

Unterstützt in: 2.0
Fanden Sie dies hilfreich?
(1500 verbleibende Zeichen)
© 2013 Microsoft. Alle Rechte vorbehalten.