Log In
Home
Support
Demos
Documentation
Blogs
Training
Webinars
[Expand]Welcome to DevExpress .NET Documentation
[Expand]WinForms Controls
[Collapse]ASP.NET Controls and MVC Extensions
 [Expand]Prerequisites
 [Expand]What's Installed
 [Expand]Common Concepts
 [Collapse]ASP.NET WebForms Controls
   Getting Started
  [Expand]Reporting
  [Expand]Chart Control
  [Expand]Grid View
  [Expand]Card View
  [Expand]Vertical Grid
  [Expand]Spreadsheet
  [Expand]Rich Text Editor
  [Expand]Image and Data Browsing
  [Expand]Docking and Popups
  [Expand]Site Navigation and Layout
  [Expand]File Management
  [Expand]Multi-Use Site Controls
  [Expand]Scheduler
  [Expand]HTML Editor
  [Expand]Pivot Grid
  [Expand]Tree List
  [Expand]Gauges
  [Collapse]Data Editors
   [Expand]Product Information
   [Expand]Common Concepts
   [Collapse]Editor Types
    [Expand]ASPxBinaryImage
     ASPxButton
     ASPxButtonEdit
     ASPxCalendar
     ASPxCheckBox
     ASPxCheckBoxList
    [Expand]ASPxColorEdit
    [Expand]ASPxComboBox
    [Expand]ASPxDateEdit
    [Expand]ASPxDropDownEdit
    [Expand]ASPxFilterControl
    [Expand]ASPxHyperLink
     ASPxImage
     ASPxLabel
    [Expand]ASPxListBox
    [Expand]ASPxMemo
    [Expand]ASPxProgressBar
     ASPxRadioButton
    [Expand]ASPxRadioButtonList
    [Expand]ASPxSpinEdit
     ASPxTextBox
     ASPxTimeEdit
    [Expand]ASPxTokenBox
    [Expand]ASPxTrackBar
     ASPxValidationSummary
  [Expand]Spell Checker
  [Expand]Query Builder
 [Expand]ASP.NET MVC Extensions
 [Expand]Localization
 [Expand]Redistribution and Deployment
  Get More Help
 [Expand]API Reference
[Expand]ASP.NET Bootstrap Controls
[Expand]ASP.NET Core Bootstrap Controls
[Expand]WPF Controls
[Expand]Xamarin Controls
[Expand]Windows 10 App Controls
[Expand]Document Server
[Expand]Reporting
[Expand]Report Server
[Expand]Dashboard
[Expand]eXpressApp Framework
[Expand]CodeRush
[Expand]CodeRush Classic
[Expand]Cross-Platform Core Libraries
[Expand]Tools and Utilities
 End-User Documentation

ASPxCheckBoxList

The ASPxCheckBoxList editor is a check box group that provides end-users with the ability to select multiple items.

View the Demo

Refer to the Check Box List online demo to see this control in action.

ASPxCheckBoxList supports both data-bound and unbound modes. This means that its contents can be generated dynamically by binding the editor to a data source, as well as manually populating the control's item collection.

Selection

The items selected within ASPxCheckBoxList can be determined by iterating through all list items and inspecting an item's ListEditItem.Selected property, or by using specific properties declared at the editor level (ASPxCheckBoxList.SelectedItems, ASPxCheckBoxList.SelectedIndices, ASPxCheckBoxList.SelectedValues). You can easily select/unselect all editor items by using the SelectAll/UnselectAll methods that are available on both the server (ASPxCheckBoxList.SelectAll/ASPxCheckBoxList.UnselectAll) and client (ASPxClientCheckBoxList.SelectAll/ASPxClientCheckBoxList.UnselectAll) sides.

Layout Customization

The ASPxCheckBoxList layout is flexibly customized. You can display check box items in several columns (ASPxCheckListBase.RepeatColumns), set a direction of items within the editor (horizontal or vertical through the ASPxCheckListBase.RepeatDirection property), and specify whether items are aligned within a table or rendered without any table structure (ASPxCheckListBase.RepeatLayout).

Custom Item Images

The ASPxCheckBoxList editor allows you to specify images for its items. You can specify one image for all items within the control using the ASPxCheckListBase.ItemImage property, or set a particular image for each item using item's ListEditItem.ImageUrl property.

Is this topic helpful?​​​​​​​