Label Element (Report Items) (RDL)

Provides a user-friendly label for an instance of an item within a report.

Syntax

<Textbox Name="..."> <!-- or Line, Rectangle, Image, Subreport, List, Matrix, Table, Chart, Grouping -->
       ...
        <Label>...</Label>
       ...
</Textbox> <!-- or /Line, /Rectangle, /Image, /Subreport, /List, /Matrix, /Table, /Chart, /Grouping -->

Element Characteristics

Characteristic Description

Data type and length

String

Default value

None

Cardinality

0-1: Optional element that can occur once or not at all.

Element Relationships

Relationship Element

Parent elements

Chart, Grouping, Image, Line, List, Matrix, Rectangle, Subreport, Table, Textbox

Child element

None

Remarks

The expression within the Label element evaluates to a variant. You can use an expression within the Label element to identify individual instances of a report item with a user-friendly name. Label is used in searches and displayed within the document map. Report item labels appear in the document map as a hierarchy that reflects the hierarchy of items within the report definition.

The label for the item does not appear in the document map if the expression contained in the Label element returns a null value, or Label is not defined. Label is not used for report items within a page header or page footer.

To cause the link in the document map to jump to a child item in the report, use the sibling LinkToChild element. LinkToChild is available only with rectangle items.

See Also

Reference

Report Definition XML Elements
LinkToChild Element (RDL)

Help and Information

Getting SQL Server 2005 Assistance