BulletedList Web 服务器控件概述
更新：2007 年 11 月
BulletedList 控件创建一个无序或有序（编号的）的项列表，它们分别呈现为 HTML ul 或 ol 元素。
本主题包括：
方案
功能
背景
帮助和演练主题
类参考
方案
BulletedList 控件用于执行以下操作：
指定列表中项、项目符号或编号的外观。
静态定义列表项或通过将控件绑定到数据来定义列表项。
响应用户对项的单击。
返回页首
功能
使用 BulletedList 控件时，可以执行以下操作：
自定义项目符号和编号的外观。
指定列表中的每一项如何呈现，如超链接、静态文本还是链接按钮。
提供用户单击某项时执行特定于应用程序的任务的逻辑。
返回页首
背景
BulletedList 控件与 ListBox、DropDownList 和其他 ASP.NET 列表控件派生自相同的 ListControl 类。因此，使用 BulletedList 控件就像使用那些控件一样。通过创建静态项或将控件绑定到数据源，可以定义 BulletedList 控件的列表项。如果在设计时知道要显示哪些项，可在标记中将控件的 Items 集合设置为一组单独的项。如果要显示的项是动态的，可以通过代码在运行时创建项集合。有关详细信息，请参见如何：在列表 Web 服务器控件中添加项 (Visual Studio)。
或者，您也可以将控件绑定到包含所要显示的信息的数据源。有关详细信息，请参见如何：根据数据源来填充列表 Web 服务器控件 (Visual Studio)。
您可以通过将控件的 AppendDataBoundItems 属性设置为 true，将静态列表项与绑定数据的列表项组合起来。
为 BulletedList 控件定义项时，要定义两个属性：Text 属性和 Value 属性。Text 属性定义控件在页上显示的内容。Value 属性定义第二个值，该值不会显示，但您可能希望在用户选择某个项时能返回该值。例如，可以将雇员的姓名显示为某项的文本，但将该雇员的 ID 用作值。当用户单击该项时，就可以直接读取该值。
.gif "安全说明") 安全说明： |
|---|
不要对 BulletedList 控件的值属性使用敏感数据（如客户号）。虽然它是不可见的，但各个项的 Value 属性设置仍将呈现在页上，用户能在该页的源代码中很容易地看到它们。 |
自定义列表项外观
BulletedList 控件可呈现项目符号或编号，具体取决于 BulletStyle 属性的设置。如果将控件设置为呈现项目符号，则可以选择与 HTML 标准项目符号样式匹配的预定义项目符号样式字段（如 Disc、Circle 和 Square 字段表示的内容）。
.gif "说明") 说明： |
|---|
各个浏览器呈现项目符号的方式各有不同，某些浏览器不支持特定的项目符号样式（如 Disc 字段）。 |
还可以指定替代项目符号显示的自定义图像。
如果将控件设置为呈现编号，您可以选择 HTML 标准编号选项（如 LowerAlpha、UpperAlpha、LowerRoman 和 UpperAlpha 字段）。通过设置 FirstBulletNumber 属性，还可以为序列指定一个起始编号。
指定项的显示模式
BulletedList 控件可以通过以下任一方式显示列表项：
静态文本 由控件所显示的文本不是交互式的。
T:System.Web.UI.WebControls.HyperLink 控件 用户可以单击链接转到其他页。您必须提供一个目标 URL 作为单个项的 Value 属性。
LinkButton控件 用户可以单击单个项，然后控件将执行一次回发。
响应用户选择
如果将 BulletedList 控件配置为将单个项显示为 LinkButton 控件，则当用户单击某项时，该控件会执行一次回发。回发将引发 BulletedList 控件的 Click 事件，可以在其中提供逻辑以执行特定于应用程序的任务。该事件将为您传递所单击的项的索引号。有关详细信息，请参见如何：响应用户在 BulletedList Web 服务器控件中的单击 (Visual Studio)。
帮助和演练主题
类参考
下表列出与 BulletedList 控件相关的类。
成员 |
说明 |
|---|---|
控件的主类。 |
|
指定每一项的显示行为的枚举。 |
|
指示所选项的索引的事件数据。 |
|
处理 BulletedList 控件的 Click 事件的方法。 |
|
指定可以显示的项目编号、编号或字母的类型的枚举。 |
返回页首
请参见
任务
如何：在列表 Web 服务器控件中添加项 (Visual Studio)