ListBox Web 服务器控件概述
更新：2007 年 11 月
ListBox Web 服务器控件使用户能够从预定义的列表中选择一项或多项。
本主题包括：
方案
功能
背景
代码示例
类参考
方案
若要一次显示多个项并使用户能够从预定义列表中选择一个或多个项，请使用 ListBox Web 服务器控件。ListBox 控件与 DropDownList 控件的不同之处在于，它可以一次显示多个项并使用户能够选择多个项（可选）。
返回页首
功能
可以使用 ListBox 控件执行下列操作：
设置控件以显示特定数目的项。
设置控件的大小（以像素为单位）。
使用数据绑定来指定要显示的项的列表。
确定选定了哪个项或哪些项。
以编程方式指定选定的一个或多个项。
返回页首
背景
ListBox 控件通常用于一次显示一个以上的项。您可以在以下几个方面控制列表的外观：
显示的行数。可将该控件设置为显示特定的项数。如果该控件包含比设置的项数更多的项，则显示一个垂直滚动条。
高度和宽度。可以以像素为单位设置控件的大小。在这种情况下，控件将忽略已设置的行数，而是显示足够多的行直至填满控件的高度。有些浏览器不支持以像素为单位设置高度和宽度，而使用行数设置。
与其他 Web 服务器控件一样，您可以使用样式对象来指定控件的外观。有关详细信息，请参见 ASP.NET Web 服务器控件和 CSS 样式。
列表项
ListBox 控件是一个或多个列表项的容器。每个列表项都是一个具有各自的属性的 ListItem 类型的对象。下表说明了这些属性。
属性 |
说明 |
|---|---|
指定在列表中显示的文本。 |
|
包含与某个项相关联的值。设置此属性使您可以将该值与特定的项关联而不显示该值。例如，可以将 Text 属性设置为某种颜色的名称，并将 Value 属性设置为其十六进制表示形式。 |
|
指示当前是否已选定此项。 |
若要以编程方式处理项，请使用 ListBox 控件的 Items 集合。Items 集合是一个标准集合，您可以向它添加项对象，也可以从中删除项或清除集合等。
当前所选项可在 ListBox 控件的 SelectedItem 属性中得到。如果将控件设置为单选模式，则此属性将返回一个选定的项。如果将控件设置为多选模式，则通过循环遍历整个 Items 集合并检查每个项的 Selected 属性来获取选定的项。
单选与多选
通常，用户可以通过单击列表中的单个项来选择它。如果将 ListBox 控件设置为允许进行多重选择，则用户可以在按住 Ctrl 或 Shift 键的同时，单击以选择多个项。
将数据绑定到控件
可以使用 ListBox Web 服务器控件列出使用数据源控件的页可使用的选项。ListBox 控件中的每个项分别对应于数据源中的一个项（通常是单个数据记录）。
控件显示来自数据源的一个字段。（可选）可将控件绑定到另一个字段以设置某个项的值（该值不显示）。
与其他服务器控件一样，您可以将任何控件属性（例如控件的颜色或大小）绑定到数据。有关详细信息，请参见如何：根据数据源来填充列表 Web 服务器控件 (Visual Studio)。
ListBox 事件
当用户选择一项时，ListBox 控件将引发 SelectedIndexChanged 事件。默认情况下，此事件不会导致将页发送到服务器，但可以通过将 AutoPostBack 属性设置为 true 使此控件强制立即回发。
.gif "说明") 说明： |
|---|
自动回发功能要求浏览器支持 ECMAScript（Jscript 或 JavaScript），并且用户的浏览器上已启用脚本撰写。 |
代码示例
如何：向 Web 窗体页添加 ListBox Web 服务器控件 (Visual Studio)
如何：在列表 Web 服务器控件中添加项 (Visual Studio)
如何：设置列表 Web 服务器控件中的选定内容 (Visual Studio)
如何：根据数据源来填充列表 Web 服务器控件 (Visual Studio)
返回页首
类参考
下表列出了与 ListBox 控件相关的类。
成员 |
说明 |
|---|---|
控件的主类。 |
|
表示列表中的每一项的类。 |
返回页首