New to Telerik ReportingStart a free 30-day trial

SubReport

A SubReport is a report component that allows you to create:

  • Reusable components—Create shared headers, footers, or report sections that can be used across multiple reports.

  • Complex layouts—Combine different data sources and report structures within a single report. Embed one report inside another report. This lets you create complex report layouts.

  • Hierarchical data presentations—Visualize various relationships scenarios depending on the data organization and design requirements:

    • Master-detail with a pair of related plain data sets—Display related data in a parent-child format (for example, categories and their products). The master report with categories passes a report parameter (CategoryID) to the child report with products to filter the relevant hierarchical data.

    • Master-detail with a single hierarchical (nested) data set—Show nested data relationships with proper hierarchical structure, grouping and organization (for example, categories as a root level and child products for the respective category). The Web Report Designer offers binding to hierarchical data using the DataSource property of the SubReport item (instead of passing a report parameter). This method is cleaner when your detail report uses report bands (sections) to represent the rows of data, not a data bound Table or Graph item for example.

    • Recursive hierarchical data presentation—Organization Structure presentation. Use recursive SubReports and a self-referencing flat data source with relation between the individual rows. The hierarchy is achieved by having the main report reference itself as a SubReport, passing a parameter that filters child records based on the parent’s ID.

SubReports act as containers that automatically adjust their size based on the content of the embedded report.

Prerequisites

Before working with SubReports, ensure you have:

  • Created and configured data sources for both master and child reports.
  • Planned your data relationships and report hierarchy.

See Also

In this article
PrerequisitesSee Also
Not finding the help you need?
Contact Support