Skip to main content

Band Class

The base for classes that provide functionality to report bands.

Namespace: DevExpress.XtraReports.UI

Assembly: DevExpress.XtraReports.v24.1.dll

NuGet Package: DevExpress.Reporting.Core


public abstract class Band :


Any XtraReport consists of bands containing various report controls. The report, its bands and controls are all descendants of the XRControl class.

A default blank report contains a DetailBand, TopMarginBand and BottomMarginBand. These bands cannot be deleted.

To create a band of a specific type in code, call the XtraReportBase.CreateBand method with the specified BandKind value.

Appearance properties specified for bands or panels propagate to child controls, even though they may not take effect for some report elements. An obvious example of this behavior is the DetailBand element, that has no visible border or background color, even though it passes appearance property settings to its child controls. Another example is the XRPageBreak control, that has the XRControl.BackColor property, but ignores its value during rendering.

Review the following help topic for more information: Appearance Properties.

If a report element has a style assigned to it, the priority of the properties defined by that style is determined by the StylePriority property. Note that if conditional formatting is involved, the appearance it defines has a higher priority.

Review the following topic for information about report bands Introduction to Banded Reports.


See Also