BandCollection.AddRange(Band[]) Method

Adds an array of Band objects to the collection.

Namespace: DevExpress.XtraReports.UI

Assembly: DevExpress.XtraReports.v20.2.dll

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

Declaration

C#

public void AddRange(
    Band[] bands
)

VB.NET

Public Sub AddRange(
    bands As Band()
)

Parameters

Name	Type	Description
bands	Band[]	An array of Band objects to add to the collection.

Remarks

The AddRange method can be used to quickly add a group of bands to the collection instead of having to manually add each band to the collection using the BandCollection.Add method.

The Band objects contained in the array passed as the parameter are appended to the end of the collection. Note that if any of the bands being added already exist in the collection the existing bands will be retained in the collection and the new duplicate bands ignored.

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the AddRange(Band[]) method.

Note

The algorithm used to collect these code examples remains a work in progress. Accordingly, the links and snippets below may produce inaccurate results. If you encounter an issue with code examples below, please use the feedback form on this page to report the issue.

C#

Reporting_how-to-use-the-web-document-viewer-in-javascript-with-reactjs-t561300/CS/ServerSide/XtraReport2.cs#L316

//
this.Bands.AddRange(new DevExpress.XtraReports.UI.Band[] {
this.topMarginBand1,

winforms-create-a-custom-exporter-for-pivotgridcontrol-with-xtrareport/CS/Report_at_Runtime/PivotReportGenerator.cs#L108

    // Place the bands onto a report
    rep.Bands.AddRange(new DevExpress.XtraReports.UI.Band[] { detail, pageHeader, reportFooter });
}

reporting-winforms-create-report-dynamically-and-bind-it-to-dataset/CS/Report_at_Runtime/Form1.cs#L78

    // Place the bands onto a report
    rep.Bands.AddRange(new DevExpress.XtraReports.UI.Band[] { detail, pageHeader, reportFooter });
}

how-to-create-a-custom-exporter-that-supports-autorowheight-bestfit-and-fittopage-t274241/CS/WpfApplication31/PivotReportGenerator.cs#L105

    // Place the bands onto a report
    rep.Bands.AddRange(new Band[] { detail, pageHeader, reportFooter });
}

Reporting_how-to-use-the-web-report-designer-in-javascript-with-reactjs-t561295/CS/ServerSide/XtraReport1.cs#L348

//
this.Bands.AddRange(new DevExpress.XtraReports.UI.Band[] {
this.topMarginBand1,

VB.NET

Reporting_how-to-use-the-web-document-viewer-in-javascript-with-reactjs-t561300/VB/ServerSide/XtraReport2.vb#L303

'
Me.Bands.AddRange(New DevExpress.XtraReports.UI.Band() { Me.topMarginBand1, Me.bottomMarginBand1, Me.reportHeaderBand1, Me.groupHeaderBand1, Me.detailBand1})
Me.ComponentStorage.AddRange(New System.ComponentModel.IComponent() { Me.sqlDataSource1})

winforms-create-a-custom-exporter-for-pivotgridcontrol-with-xtrareport/VB/Report_at_Runtime/PivotReportGenerator.vb#L109

    ' Place the bands onto a report
    rep.Bands.AddRange(New Band() {detail, pageHeader, reportFooter})
End Sub

reporting-winforms-create-report-dynamically-and-bind-it-to-dataset/VB/Report_at_Runtime/Form1.vb#L80

    ' Place the bands onto a report
    rep.Bands.AddRange(New DevExpress.XtraReports.UI.Band() { detail, pageHeader, reportFooter })
End Sub

how-to-create-a-custom-exporter-that-supports-autorowheight-bestfit-and-fittopage-t274241/VB/WpfApplication31/PivotReportGenerator.vb#L116

    ' Place the bands onto a report
    rep.Bands.AddRange(New Band() { detail, pageHeader, reportFooter })
End Sub

Reporting_how-to-use-the-web-report-designer-in-javascript-with-reactjs-t561295/VB/ServerSide/XtraReport1.vb#L332

'
Me.Bands.AddRange(New DevExpress.XtraReports.UI.Band() { Me.topMarginBand1, Me.bottomMarginBand1, Me.reportHeaderBand1, Me.groupHeaderBand1, Me.detailBand1})
Me.ComponentStorage.AddRange(New System.ComponentModel.IComponent() { Me.sqlDataSource1})