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 控件中。