BandCollection.AddRange(Band[]) Method

Adds an array of Band objects to the collection.

Namespace: DevExpress.XtraReports.UI

Assembly: DevExpress.XtraReports.v24.2.dll

NuGet Package: DevExpress.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

When you create or edit a report, use the AddRange method to add new bands. Note that some band types should appear only once in the report, while other band types can be added multiple times. When you attempt to add a band of a type that cannot be duplicated in the report, an exception occurs with the message Msg_IncorrectBandType.

Note that the AddRange method is not intended to copy bands from one report to another. You must create a new Band instance, and then add it to the BandCollection.

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-web-forms-handle-server-side-errors/CS/DXWebApplication1/Reports/XtraReport3.cs#L69

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

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

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

Reporting-Bind-Report-To-Federated-Master-Detail-Data-Source/CS/Form1.cs#L71

detailReport.Bands.Add(detailBand2);
report.Bands.AddRange(new Band[] { detailBand, detailReport });
// Add a label bound to the "ProductName" data field.

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

    var reportFooter = new ReportFooterBand() { HeightF = 380 };
    report.Bands.AddRange(new Band[] { detail, pageHeader, reportFooter });
}

reporting-winforms-create-table-at-runtime/CS/Form1.cs#L124

var detailBand = new DetailBand();
report.Bands.AddRange(new Band[] { pageHeaderBand, detailBand });
return report;

VB.NET

reporting-web-forms-handle-server-side-errors/VB/DXWebApplication1/Reports/XtraReport3.vb#L67

'
Me.Bands.AddRange(New DevExpress.XtraReports.UI.Band() { Me.TopMargin, Me.BottomMargin, Me.Detail})
Me.Font = New DevExpress.Drawing.DXFont("Arial", 9.75F)

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

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

reporting-wpf-use-private-custom-font-distributed-with-application/VB/PrivateFontDemo/SampleReport.vb#L59

'
Bands.AddRange(New Band() {Detail, TopMargin, BottomMargin})
Version = "18.2"

Reporting-Bind-Report-To-Federated-Master-Detail-Data-Source/VB/Form1.vb#L71

detailReport.Bands.Add(detailBand2)
report.Bands.AddRange(New Band() { detailBand, detailReport })
' Add a label bound to the "ProductName" data field.

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

    Dim reportFooter = New ReportFooterBand() With {.HeightF = 380}
    report.Bands.AddRange(New Band() { detail, pageHeader, reportFooter })
End Sub