ASP.NET CheckBoxList 控件

定义和用法

CheckBoxList 控件用于创建多选的复选框组。

每个 CheckBoxList 控件中的可选项都是由 ListItem 元素定义的！

提示：该控件支持数据绑定！

属性

属性	描述	.NET
CellPadding	表格单元格的边框与内容之间的像素数。	1.0
CellSpacing	表格单元格之间的像素数。	1.0
RepeatColumns	当显示复选框组时所用的列数。	1.0
RepeatDirection	规定复选框组水平重复还是垂直重复。	1.0
RepeatLayout	复选框组的布局。	1.0
runat	规定该控件是服务器控件。必须设置为 "server"。	1.0
TextAlign	文本出现在复选框的哪一侧。	1.0

ListControl 标准属性

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

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

如需完整描述，请访问 ListControl 标准属性。

Web 控件标准属性

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

如需完整描述，请访问 Web 控件标准属性。

控件标准属性

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

如需完整描述，请访问控件标准属性。

实例

CheckBoxList

<script  runat="server">
Sub Check(sender As Object, e As EventArgs)
   dim i
   mess.Text="<p>Selected Item(s):</p>"
   for i=0 to check1.Items.Count-1
     if check1.Items(i).Selected then
       mess.Text+=check1.Items(i).Text + "<br>"
     end if
   next
End Sub
</script>
 
<!DOCTYPE html>
<html>
<body>
 
<form runat="server">
<asp:CheckBoxList id="check1" AutoPostBack="True"
TextAlign="Right" OnSelectedIndexChanged="Check"
runat="server">
<asp:ListItem>Item 1</asp:ListItem>
<asp:ListItem>Item 2</asp:ListItem>
<asp:ListItem>Item 3</asp:ListItem>
<asp:ListItem>Item 4</asp:ListItem>
<asp:ListItem>Item 5</asp:ListItem>
<asp:ListItem>Item 6</asp:ListItem>
</asp:CheckBoxList>
<br>
<asp:label id="mess" runat="server"/>
</form>
 
</body>
</html>

在本例中，我们在 .aspx 文件中声明了一个 CheckBoxList 控件。然后我们为 SelectedIndexChanged 事件创建了一个事件句柄。这个可选列表包含六个复选框。当用户选中其中之一，页面会自动传回服务器，并执行 Check 子例程。该子例程会遍历控件的 Items 集合，并测试每个项目的 Selected 属性。被选的项目会显示在 Label 控件中。