BulletStyle 枚举

定义

指定项目符号样式,该样式可应用于 BulletedList 控件中的列表项。

public enum BulletStyle
继承
BulletStyle

字段

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 枚举值。 项目符号样式会根据用户从列表框中选择的样式而更改。


<%@ 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 项目符号样式。 例如,如果将 属性设置为 BulletStyleDisc,则控件中的每个 BulletedList 列表项将在列表项内容之前呈现一个填充的圆圈,如下所示:

  • List Item 1

  • List Item 2

  • List Item 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

另请参阅