SubreportBase.ReportSource Property
Specifies an XtraReport object to be included as a subreport.
Namespace: DevExpress.XtraReports.UI
Assembly: DevExpress.XtraReports.v18.2.dll
Declaration
Property Value
| Type | Description |
|---|---|
| XtraReport | An XtraReport object to be included. |
Remarks
At design time, to be able to preview the report, rebuild the application before setting the ReportSource property.
Instead of assigning an XtraReport instance to the ReportSource property, you can assign an URL of a report definition file (.REPX) to the XRSubreport.ReportSourceUrl property.
Example
This example illustrates the use of the XRSubreport control at runtime.
Not that at runtime, you can also assign a subreport by handling the XRControl.BeforePrint event of the XRSubreport control and setting its SubreportBase.ReportSource property.
using DevExpress.XtraReports.UI;
// ...
private void xrSubreport1_BeforePrint(object sender, System.Drawing.Printing.PrintEventArgs e) {
((XRSubreport)sender).ReportSource = new WindowsFormsApplication1.Reports.XtraReport3();
}
The following example demonstrates how to create a XRSubreport control and adjust some of its main properties (e.g. SubreportBase.ReportSource). This example assumes that an XtraReport object passed as a parameter to the CreateCompositeReport method, has already been created in the current project.
Tip
Online Example: How to create an XRSubreport control
using System.Drawing;
using DevExpress.XtraReports.UI;
// ...
public XtraReport CreateCompositeReport(XtraReport detailReport) {
// Create a report.
XtraReport mainReport = new XtraReport();
// Create a subreport.
XRSubreport subreport = new XRSubreport();
// Create a detail band and add it to the main report.
DetailBand detailBand = new DetailBand();
mainReport.Bands.Add(detailBand);
// Set the subreport's location.
subreport.Location = new Point(110, 100);
// Specify a detail report as a report source for the subreport.
subreport.ReportSource = detailReport;
// Add the subreport to the detail band.
detailBand.Controls.Add(subreport);
return mainReport;
}
Related GitHub Examples
The following code snippets (auto-collected from DevExpress Examples) contain references to the ReportSource property.
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.