Subreport Element (RDL)

Contains information about a report to be included within the report.

Syntax

<ReportItems>
    ...
<Subreport Name="...">
        <Style>...</Style>
        <Top>...</Top>
        <Left>...</Left>
        <Height>...</Height>
        <Width>...</Width>
        <ZIndex>...</ZIndex>
        <Visibility>...</Visibility>
        <ToolTip>...</ToolTip>
        <Label>...</Label>
        <Bookmark>...</Bookmark>
        <Custom>...</Custom>
        <ReportName>...</ReportName>
        <Parameters>...</Parameters>
        <NoRows>...</NoRows>
        <MergeTransactions>...</MergeTransactions>
    </Subreport>
    ...
</ReportItems>

Element Characteristics

Characteristic	Description
Data type and length	None
Default value	None
Cardinality	0-n: Optional element that can occur once or more.

Element Attributes

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

Element Relationships

Relationship	Element
Parent element	ReportItems
Child elements	Bookmark, Custom, Height, Label, Left, MergeTransactions, NoRows, Parameters, ReportName, Style, ToolTip, Top, Visibility, Width, ZIndex

Remarks

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 repeating item such as list, table, or matrix.

Subreports can be nested.

If a subreport fails to execute, the subreport is replaced with a text box that contains an error message. Style information for the subreport is applied to the text box.

See Also

Reference

Report Definition XML Elements

Help and Information

Getting SQL Server 2005 Assistance