Subreport Element (RDL)

[This topic is pre-release documentation and is subject to change in future releases. Blank topics are included as placeholders.]

Contains information about a report that is included within another report.

Element Attributes

Attribute	Type	Description
Name	String	Name of the subreport. Required.

Element Relationships

Relationship	Element
Parent element	ReportItems Element (RDL), CellContents Element (RDL), AltReportItem Element (RDL)
Child elements	Element Cardinality Type BackgroundColor Element (RDL) [0-1] Expression (Color) BackgroundGradientEndColor Element (RDL) [0-1] Expression (Color) BackgroundGradientType Element (RDL) [0-1] Expression (Enum) BackgroundImage Element (RDL) [0-1] Element Bookmark Element (RDL) [0-1] Expression (String) Border Element (RDL) [0-1] Element BottomBorder Element (RDL) [0-1] Element Calendar Element (RDL) [0-1] Expression (Enum) Color Element (RDL) [0-1] Expression (Color) CustomProperties Element (RDL) [0-1] Element DataElementName Element (RDL) [0-1] String DataElementOutput Element (RDL) [0-1] Enum Direction Element, Style (RDL) [0-1] Expression (Enum) DocumentMapLabel Element, ReportItem (RDL) [0-1] Expression (String or Variant) FontFamily Element (RDL) [0-1] Expression (String) FontSize Element (RDL) [0-1] Expression (Size) FontStyle Element (RDL) [0-1] Expression (Enum) FontWeight Element (RDL) [0-1] Expression (Enum) Format Element (RDL) [0-1] Expression (String) Height Element (RDL) [0-1] Size Element, (RDL) Language Element, Style (RDL) [0-1] Expression (Language) Left Element (RDL) [0-1] Size Element, (RDL) LeftBorder Element (RDL) [0-1] Element LineHeight Element (RDL) [0-1] Expression (Size) Name Element, Custom Property (RDL) 1 Element NumeralLanguage Element (RDL) [0-1] Expression (Language) NumeralVariant Element (RDL) [0-1] Expression (Integer) PaddingBottom Element (RDL) [0-1] Expression (Size) PaddingLeft Element (RDL) [0-1] Expression (Size) PaddingRight Element (RDL) [0-1] Expression (Size) PaddingTop Element (RDL) [0-1] Expression (Size) RightBorder Element (RDL) [0-1] Element TextAlign Element (RDL) [0-1] Expression (Enum) TextDecoration Element (RDL) [0-1] Expression (Enum) ToolTip Element (RDL) [0-1] Expression (String or Variant) Top Element (RDL) [0-1] Size Element, (RDL) TopBorder Element (RDL) [0-1] Element UnicodeBiDi Element (RDL) [0-1] Expression (Enum) VerticalAlign Element (RDL) [0-1] Expression (Enum) Visibility Element (RDL) [0-1] Element Width Element (RDL) [0-1] Size Element, (RDL) WritingMode Element (RDL) [0-1] Expression (Enum) ZIndex Element (RDL) [0-1] Integer KeepTogether Element (RDL) [0-1] Boolean MergeTransactions Element (RDL) [0-1] Boolean NoRowsMessage Element (RDL) [0-1] Expression (String) OmitBorderOnPageBreak Element (RDL) [0-1] Boolean Parameters Element (RDL) [0-1] Element ReportName Element (RDL) 1 String

Remarks

A Subreport element is a type of ReportItem element.

Subreports can be nested. Subreports may not be contained in a PageSection element. The subreport Style property applies to the text box that contains the subreport.

When a subreport fails to execute during report processing, the report renderer displaysthe error message on the report page in the same location as the subreport would have been rendered

The NoRowsMessage text displays in the subreport when no data is available for any subreport dataset used in the Body element of the subreport.

If no parameters are specified and the report contains no toggle elements, the subreport runs only once, even if the subreport is contained within a data region item such as a Tablix element.

When the ReportParameter property UsedInQuery is set to Auto (the default), a reference to a subreport sets the value to True.

You can use the MergeTransactions element to merge transactions that are used in the subreport with the transactions in the parent report if the data sources are the same.

The following Report properties do not apply to Subreport: Description, Author, AutoRefresh, Width, Page, DataTransform, DataSchema. The following ReportItem properties do not apply to Subreport: Action, RepeatWith.

See Also

Reference

Report Definition Language XML Schema
Report Definition XML Elements

Concepts

Report Definition Language Data Types

Other Resources

Development (Reporting Services)
Working with Report Items
Adding a Subreport

Help and Information

Getting SQL Server 2008 Assistance