Back to Devexpress

BandCollection.AddRange(Band[]) Method

xtrareports-devexpress-dot-xtrareports-dot-ui-dot-bandcollection-dot-addrange-x28-devexpress-dot-xtrareports-dot-ui-dot-band-x29.md

latest6.5 KB
Original Source

BandCollection.AddRange(Band[]) Method

Adds an array of Band objects to the collection.

Namespace : DevExpress.XtraReports.UI

Assembly : DevExpress.XtraReports.v25.2.dll

NuGet Package : DevExpress.Reporting.Core

Declaration

csharp
public void AddRange(
    Band[] bands
)
vb
Public Sub AddRange(
    bands As Band()
)

Parameters

NameTypeDescription
bandsBand[]

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.

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.

reporting-web-forms-handle-server-side-errors/CS/DXWebApplication1/Reports/XtraReport3.cs#L69

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

reporting-winforms-create-hierarchical-report-in-code/CS/CreateHierarchicalReport/ReportCreator.cs#L79

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

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

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

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

csharp
// 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

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

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

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

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

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

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

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

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

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

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

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

See Also

BandCollection Class

BandCollection Members

DevExpress.XtraReports.UI Namespace