定义和用法
CheckBoxList
控件用于创建多选的复选框组。
每个 CheckBoxList
控件中的可选项都是由 ListItem
元素定义的!
提示:该控件支持数据绑定!
属性
属性 | 描述 |
---|---|
CellPadding | 表格单元格的边框与内容之间的像素数。 |
CellSpacing | 表格单元格之间的像素数。 |
RepeatColumns | 当显示复选框组时所用的列数。 |
RepeatDirection | 规定复选框组水平重复还是垂直重复。 |
RepeatLayout | 复选框组的布局。 |
runat | 规定该控件是服务器控件。必须设置为 “server”。 |
TextAlign | 文本出现在复选框的那一侧。 |
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
实例
<%@ Page Language="C#" AutoEventWireup="true" CodeBehind="TEST.aspx.cs" Inherits="Pro.TEST" %>
<!DOCTYPE html>
<html xmlns="http://www.w3.org/1999/xhtml">
<head runat="server">
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<title></title>
<script runat="server">
public void Check(Object sender, EventArgs e)
{
int i = 0;
mess.Text = "<p>Selected Item(s):</p>";
for (i = 0; i < check1.Items.Count; i++)
{
if (check1.Items[i].Selected)
{
mess.Text += check1.Items[i].Text + "<br />";
}
}
}
</script>
</head>
<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
控件中。