Web服务器控件：BulletedList控件-ASP.NET教程-网络编程

阅读此文请先查看网页教学网的：ASP.NET入门教程:Web服务器控件，简单讲述了Web服务器控件的使用方法。

定义和用法

BulletedList 能够以项目符号的格式来创建列表。创建一个控件，该控件以项目符号格式生成项列表

BulletedList 控件中的每个项目都由 ListItem 元素来定义！

注释：它是 ASP.NET 2.0 中的新类。

属性

ListControl 标准属性

AppendDataBoundItems, AutoPostBack, CausesValidation, DataTextField,DataTextFormatString, DataValueField, Items, runat, SelectedIndex, SelectedItem,SelectedValue, TagKey, Text, ValidationGroup, OnSelectedIndexChanged

ListControl 控件包括列表控件的所有基本功能。继承自此控件的控件包括：CheckBoxList, DropDownList, ListBox 以及 RadioButtonList 控件。

Web 控件标准属性

AccessKey, Attributes, BackColor, BorderColor, BorderStyle, BorderWidth, CssClass, Enabled, Font, EnableTheming, ForeColor, Height, IsEnabled, SkinID, Style, TabIndex, ToolTip, Width

控件标准属性

AppRelativeTemplateSourceDirectory, BindingContainer, ClientID, Controls, EnableTheming, EnableViewState, ID, NamingContainer, Page, Parent, Site, TemplateControl, TemplateSourceDirectory, UniqueID, Visible

语法

<asp:BulletedList
    AccessKey="string"
    AppendDataBoundItems="True|False"
    AutoPostBack="True|False"
    BackColor="color name|#dddddd"
    BorderColor="color name|#dddddd"
    BorderStyle="NotSet|None|Dotted|Dashed|Solid|Double|Groove|Ridge|
        Inset|Outset"
    BorderWidth="size"
    BulletImageUrl="uri"
    BulletStyle="NotSet|Numbered|LowerAlpha|UpperAlpha|LowerRoman|
        UpperRoman|Disc|Circle|Square|CustomImage"
    CausesValidation="True|False"
    CssClass="string"
    DataMember="string"
    DataSource="string"
    DataSourceID="string"
    DataTextField="string"
    DataTextFormatString="string"
    DataValueField="string"
    DisplayMode="Text|HyperLink|LinkButton"
    Enabled="True|False"
    EnableTheming="True|False"
    EnableViewState="True|False"
    FirstBulletNumber="integer"
    Font-Bold="True|False"
    Font-Italic="True|False"
    Font-Names="string"
    Font-Overline="True|False"
    Font-Size="string|Smaller|Larger|XX-Small|X-Small|Small|
        Medium|Large|X-Large|XX-Large"
    Font-Strikeout="True|False"
    Font-Underline="True|False"
    ForeColor="color name|#dddddd"
    Height="size"
    ID="string"
    OnClick="Click event handler"
    OnDataBinding="DataBinding event handler"
    OnDataBound="DataBound event handler"
    OnDisposed="Disposed event handler"
    OnInit="Init event handler"
    OnLoad="Load event handler"
    OnPreRender="PreRender event handler"
    OnSelectedIndexChanged="SelectedIndexChanged event handler"
    OnTextChanged="TextChanged event handler"
    OnUnload="Unload event handler"
    runat="server"
    SkinID="string"
    Style="string"
    TabIndex="integer"
    Target="string|_blank|_parent|_search|_self|_top"
    ToolTip="string"
    ValidationGroup="string"
    Visible="True|False"
    Width="size"
>
            <asp:ListItem
                Enabled="True|False"
                Selected="True|False"
                Text="string"
                Value="string"
            />
</asp:BulletedList>

备注：使用 BulletedList 控件创建设置为项目符号格式的项列表。若要指定要在 BulletedList 控件中显示的各列表项，请针对每项在 BulletedList 控件的开始标记和结束标记之间放置一个 ListItem 对象。

示例

下面的代码示例演示如何创建一个 BulletedList 控件，该控件具有设置为链接按钮格式的列表项。

Visual Basic

<asp:BulletedList id="ItemsBulletedList" BulletStyle="Disc"
                  DisplayMode="LinkButton" runat="server">
  <asp:ListItem Value="http://www.webjx.com">Webjx Com</asp:ListItem>
  <asp:ListItem Value="http://www.contoso.com">Contoso, Ltd.</asp:ListItem>
  <asp:ListItem Value="http://www.tailspintoys.com">Tailspin Toys</asp:ListItem>
</asp:BulletedList>

C#

<asp:BulletedList id="ItemsBulletedList" BulletStyle="Disc"
                  DisplayMode="LinkButton" runat="server">
  <asp:ListItem Value="http://www.webjx.com">Webjx Com</asp:ListItem>
  <asp:ListItem Value="http://www.contoso.com">Contoso, Ltd.</asp:ListItem>
  <asp:ListItem Value="http://www.tailspintoys.com">Tailspin Toys</asp:ListItem>
</asp:BulletedList>