Log In
[Expand]General Information
[Expand]WinForms Controls
[Expand]ASP.NET Controls and MVC Extensions
[Expand]ASP.NET Bootstrap Controls
[Expand]ASP.NET Core Bootstrap Controls
[Expand]WPF Controls
[Expand]Xamarin Controls
[Expand]Windows 10 App Controls
[Expand]Office File API
[Expand]Report and Dashboard Server
[Collapse]eXpressApp Framework
 [Expand]Getting Started
  [Expand]Application Solution Components
   Client-Side Mobile Application
  [Expand]Business Model Design
  [Expand]Application Model
  [Collapse]UI Construction
    UI Element Overview
    Windows and Frames
    Action Containers
     Ways to Show a View
     List View Column Generation
     List View Columns Customization
     List View Bands Layout
     List View Edit Modes
    [Expand]List View Data Access Modes Overview
     Display Properties of a Referenced Object in the Master Object's View
   [Expand]View Items
    List Editors
    Add and Override Images
    Text Notifications
    Ways to Show a Confirmation Dialog
    ASP.NET Web Application Appearance
    Application Personalization
    Using a Custom Control that is not Integrated by Default
    XAF Mobile Wrappers for DevExtreme Widgets
  [Expand]Extend Functionality
  [Expand]Data Manipulation and Business Logic
  [Expand]Security System
  [Expand]System Module
  [Expand]Extra Modules
  [Expand]Debugging, Testing and Error Handling
  [Expand]Application Life Cycle
 [Expand]Design-Time Features
 [Expand]Task-Based Help
  Frequently Asked Questions (FAQ)
 [Expand]API Reference
[Expand]CodeRush Classic
[Expand]Cross-Platform Core Libraries
[Expand]Tools and Utilities
 End-User Documentation
This documentation page describes implementations made in our v17.2 release cycle. To learn about functionality shipping with v18.1, navigate to our updated help file experience at docs.devexpress.com. Learn More

List View Bands Layout

Band is a logical group of columns. In the WinForms Data Grid and ASP.NET Grid View controls, a band is visualized as a header displayed above headers of the columns it combines. This topic describes the use of the Banded Grid Views feature in a WinForms XAF application and the Bands feature in an ASP.NET XAF application.


You can see the demonstration of bands in the List Editors | Grid | Banded List View section of the Feature Center demo. The Feature Center demo is installed in %PUBLIC%\Documents\DevExpress Demos 18.1\Components\eXpressApp Framework\FeatureCenter by default. The ASP.NET version of this demo is available online at http://demos.devexpress.com/XAF/FeatureCenter/.

Expanded Bands Layout

Bands layout is defined in the Application Model by the structure of the IModelBandsLayout node.

You can add IModelBand child nodes using the Add... | Band context menu command to define bands, and then drag-and-drop columns into the created bands. You can add a band inside an existing band to create a complex bands hierarchy.


Step-by-step instructions on how to configure the bands layout displayed above is available in the How to: Configure Bands in a Grid List Editor (WinForms and ASP.NET) topic.

Bands layout settings have effect on the List View only when the IModelBandsLayout.Enable property is set to true. By default, this property is set to false and you cannot add bands.

The IModelListView.EditorType property of the banded List View should be GridListEditor or ASPxGridListEditor (the actual List Editor type is available in the platform-specific project's model). Other built-in List Editors do not support bands.

Expanded Row Index

In a WinForms application, the Banded Grid Views is used to display bands. It allows you to arrange column headers across rows. You can also stretch column headers vertically so that they occupy more than one row. The column header vertical position is identified by the IModelBandedColumnWin.RowIndex property of the Views | <ListView> | BandsLayout | Band | Column node.

This property specifies the zero-based row number of the current column within a band. In the image below, the Subject column's RowIndex is 1. The RowIndex of the Status and Assigned To columns is 0.

Expanded Headers Visibility

You can hide band and column headers using the IModelBandsLayoutWin.ShowBands and IModelBandsLayoutWin.ShowColumnHeaders properties of the Views | <ListView> | BandsLayout node.

These properties are available in WinForms projects only.

Expanded End-User Customizations

A user can rearrange bands, reorder columns within a band, move columns and bands from one parent band to another. The modified layout is saved to the user differences of the Application Model. In WinForms applications, you can restrict these customizations using the following properties of the Views | <ListView> | BandsLayout node.

These properties are available in WinForms projects only.

You can use the Reset View Settings Action to undo all runtime customizations in the current View.


When configuring bands, keep in mind the differences in behavior between WinForms and ASP.NET grid controls:

  • Columns that are not added to any band are visible in ASP.NET applications only. The WinForms grid control does not display such columns.
  • The IModelBandedColumnWin.RowIndex option is available for WinForms only. You cannot arrange column headers across rows in ASP.NET applications.
  • Options that restrict band configuration by users (see IModelBandsLayoutWin) are available in WinForms only.
That is why we recommend the following:
  • Setup bands separately for WinForms and ASP.NET. Configuring bands in a platform-agnostic module is suitable for very simple band layouts only.
  • Avoid merging platform-specific band configuration in a common module.

Expanded See Also

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