Log In
[Expand]General Information
[Expand]WinForms Controls
[Expand]ASP.NET Controls and MVC Extensions
[Expand]ASP.NET Bootstrap Controls
[Expand]ASP.NET Core Bootstrap Controls
[Expand]WPF Controls
[Expand]Xamarin Controls
[Expand]Windows 10 App Controls
[Expand]Office File API
 [Expand]Product Information
 [Expand]Getting Started with DevExpress Reporting
 [Expand]Creating Popular Reports
 [Collapse]Detailed Guide to DevExpress Reporting
   Introduction to Banded Reports
  [Expand]Providing Data to Reports
  [Expand]Using Report Controls
  [Expand]Shaping Report Data
   Laying out Dynamic Report Contents
  [Expand]Customizing Appearance
  [Expand]Adding Navigation
  [Expand]Providing Interactivity
  [Expand]Adding Customary Information
  [Collapse]Merging Reports
    Adding a Title Page to a Report
    Combining Reports by Alternating Pages
  [Expand]Using Expressions
  [Expand]Storing and Distributing Reports
  [Expand]Reporting API
 [Expand]Visual Studio Report Designer
 [Expand]Creating End-User Reporting Applications
 [Expand]API Reference
[Expand]Report and Dashboard Server
[Expand]eXpressApp Framework
[Expand]CodeRush Classic
[Expand]Cross-Platform Core Libraries
[Expand]Tools and Utilities
 End-User Documentation
This documentation page describes implementations made in our v17.2 release cycle. To learn about functionality shipping with v18.1, navigate to our updated help file experience at docs.devexpress.com. Learn More

Merging Reports

A report may include pages that do not fit an entire report template, for example, a title page, charts within a table report, pages with an alternative orientation or specific pages at the end of a report. Report Merging enables you to add such pages by merging pages you created in a separate report with the base report. It also allows you to print and export merged pages as a single document while preserving the original reports' page settings and orientation.

Expanded Report Merging Overview

To merge reports, generate report documents by calling the XtraReport.CreateDocument method and put report pages in a specific order using the XtraReport.Pages property.

Alternatively, you can handle a report's XRControl.AfterPrint event, which is raised after a document for the report is generated, to access the page collection.

You can update the page numbers or preserve the original page numbers using the PrintingSystemBase.ContinuousPageNumbering property if you have pages numbered in the base report.


Do not dispose of the merged documents before publishing the resulting document (the resulting document does not create a "deep copy" of merged documents).

Expanded Composite Documents

Composite report documents created from multiple merged documents do not support continuous (single file) export. An attempt to export a composite document to a single file only exports its first merged document. As a workaround, you can use subreports to display multiple reports in a single document, or you can export individual documents to separate files and then manually combine them into a single file.

Expanded Limitations

The following limitations apply to merged documents when previewing them:

Is this topic helpful?​​​​​​​