ASP.NET CheckBoxList 控件
Web 伺服器控件
定義和用法
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
在本例中，我們在 .aspx 檔中聲明了一個 CheckBoxList 控件。然後我們為 SelectedIndexChanged 事件創建了一個事件句柄。這個可選列表包含六個複選框。當用戶選中其中之一，頁面會自動傳回伺服器，並執行 Check 子例程。該子例程會遍曆控件的 Items 集合，並測試每個專案的 Selected 屬性。被選的專案會顯示在 Label 控件中。
Web 伺服器控件