定義和用法
CheckBoxList控件用來建立一個多選的復選框組。
CheckBoxList控件中的每個可選項由一個ListItem元素來定義！
提示：此控件支持數據綁定！
屬性
屬性 |
說明 |
AutoPostBack
指定在某一項的選擇狀態發生改變後表單是否被立即投遞的一個布爾值。默認值是false
CellPadding
單元格邊界與復選框組之間的間距，以象素表示
DataSource
使用的數據源
DataTextFIEld
數據源中的一個字段，將被顯示於復選框組中
DataValueFIEld
數據源中的一個字段，指定復選框組中每個可選項的值
id
此控件的唯一id
OnSelectedIndExchanged
當某項的選擇狀態發生改變時將執行的函數的名稱
RepeatColumns
顯示復選框組時使用的列數。默認值是"1"
RepeatDirection
指定復選框組將按水平還是垂直方向重復。合法的值為"Horizontal" 和 "Vertical"。默認值是Vertical
RepeatLayout
復選框組的布局。可以是 "Table" 或 "Flow"。默認值是Table
runat
規定此控件是服務器控件。必須被設置為"server"
TextAlign
文本出現在復選框的哪一側（右側或左側）
示例
在此示例中我們在一個.ASPx文件中聲明一個CheckBoxList控件。然後我們為SelectedIndExchanged事件建立一個事件句柄。此可選列表包含了6個復選框。當用戶勾選其中之一的時候，頁面立即被投遞回服務器，並且Check子程序被執行。該子程序在控件的選項集合中循環測試每項的Selected屬性。被選中項被顯示於Label控件中。本信息代表文章來源網頁教學webjx.com請大家去www.webjxcom浏覽！
<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>
<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>
