閱讀英文版本

分享方式：

BulletStyle 列舉

  • 參考

定義

命名空間:
System.Web.UI.WebControls
組件:
System.Web.dll

指定可以套用至 BulletedList 控制項中之清單項目的項目符號樣式。

C# 
public enum BulletStyle
繼承
Object
ValueType
Enum
BulletStyle

欄位

名稱 值 Description
Circle 7

項目符號樣式為空心圓形。
CustomImage 9

項目符號樣式為自訂影像。
Disc 6

項目符號樣式為實心圓形。
LowerAlpha 2

項目符號樣式為小寫字母 (a、b、c...)。
LowerRoman 4

項目符號樣式為小寫羅馬數字 (i、ii、iii...)。
NotSet 0

項目符號樣式未設定。 呈現 BulletedList 控制項的瀏覽器將決定要顯示的項目符號樣式。
Numbered 1

項目符號樣式為數字 (1、2、3...)。
Square 8

項目符號樣式為實心方形。
UpperAlpha 3

項目符號樣式為大寫字母 (A、B、C...)。
UpperRoman 5

項目符號樣式為大寫羅馬數字 (I、II、III...)。

範例

下列範例示範如何建立 BulletedList 控件。 控件 ListBox 會填入所有可用的 BulletStyle 列舉值。 項目符號樣式會根據使用者從清單框中選取的樣式而變更。

ASP.NET (C#) 

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

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>
            BulletStyle Example</title>
<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" AssociatedControlID="BulletStylesListBox" />
    </form>
</body>
</html>

備註

列舉 BulletStyle 表示您可以套用至 控件中 BulletedList 清單專案的項目符號樣式。 屬性 BulletStyle 會使用這些列舉值來設定 控件中的 BulletedList 項目符號樣式。 例如，如果您將 BulletStyle 屬性設定為 Disc，控件中的每個 BulletedList 清單專案都會在清單專案的內容前面呈現填滿的圓形，如下所示：

  • 清單項目 1

  • 清單項目 2

  • 清單項目 3

指定 CustomImage 項目符號樣式可讓您提供自己的項目符號影像。 如果您指定 CustomImage 項目符號樣式，您也必須將 BulletImageUrl 屬性設定為要使用的自定義影像 URL。

如果您指定 NotSet，則轉譯控件的瀏覽器會決定要與控件中的 BulletedList 清單專案一起顯示的項目符號樣式。

適用於

產品 版本
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1

另請參閱