Skip to main content
A newer version of this page is available. .

SubBand Class

A report band that provides a functional copy of the source band below which it is located.

Namespace: DevExpress.XtraReports.UI

Assembly: DevExpress.XtraReports.v20.2.dll

NuGet Packages: DevExpress.Reporting.Core, DevExpress.WindowsDesktop.Reporting.Core

Declaration

public class SubBand :
    Band

Remarks

To access the SubBandCollection belonging to a report Band, use its Band.SubBands property.

The following image illustrates the corresponding option in the context menu of an GUI.

report-sub-band-context-menu-end-user-designer

A band can have an unlimited number of sub-bands. Adding sub-bands is provided for all types of bands, except for the MarginBand and the SubBand itself.

After adding a sub-band to the collection, it provides a functional copy of the source band. A sub-band’s behavior, as well as its position within the report band hierarchy, is dictated by the source band type.

report-sub-band-variety-end-user-designer

By using sub-bands, it is possible to create multiple versions of a band within a single report (e.g., to choose an appropriate version later on based on a specific condition).

See Introduction to Banded Reports for more details.

See Also