ASP.NET CheckBoxList Control

Web Server Controls Web Server Controls

Definition and Usage

The CheckBoxList control is used to create a multi-selection check box group.

Each selectable item in a CheckBoxList control is defined by a ListItem element!

Tip: This control supports data binding!


Property Description .NET
CellPadding The amount of pixels between the border and the contents of the table cell 1.0
CellSpacing The amount of pixels between table cells 1.0
RepeatColumns The number of columns to use when displaying the check box group 1.0
RepeatDirection Specifies whether the check box group should be repeated horizontally or vertically 1.0
RepeatLayout The layout of the check box group 1.0
runat Specifies that the control is a server control. Must be set to "server" 1.0
TextAlign On which side of the check box the text should appear 1.0

ListControl Standard Properties

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

The ListControl control covers all the base functions for list controls. Controls that inherits from this control include the CheckBoxList, DropDownList, ListBox, and RadioButtonList controls.

For a full description, go to ListControl Standard Attributes.

Web Control Standard Properties

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

For a full description, go to Web Control Standard Attributes.

Control Standard Properties

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

For a full description, go to Control Standard Attributes.


Declare one CheckBoxList control in an .aspx file. Then we create an event handler for the SelectedIndexChanged event. The selectable list contains six check boxes. When a user checks one of the boxes, the page is immediately posted back to the server, and the Check subroutine is executed. The subroutine loops through the control's Items collection and tests each item's Selected property. The selected items are then displayed in the Label control.

Web Server Controls Web Server Controls