Subreport Element (RDL)

  • Article

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