devenv-includecaption-property.md

title	description	ms.author	ms.date	ms.topic	author	ms.reviewer
IncludeCaption Property	Sets whether to include the caption of a field in the data set of a report.	solsen	05/14/2024	reference	SusanneWindfeldPedersen	solsen

IncludeCaption Property

Version: Available or changed with runtime version 1.0.

Sets whether to include the caption of a field in the data set of a report.

Applies to

• Report Column

Property Value

True includes the caption in the report dataset; otherwise false. The default value is false.

Remarks

If IncludeCaption is set to True on a column in a dataitem, then a corresponding label called {column name}Caption is included in the dataset. The structure of where labels are available depends on the layout type (Excel, Word, or RDLC). For more information, see Report labels.

If you want to use the Caption or CaptionML values of a field as a label on a report layout, then you must include the caption in the dataset. If you do not include the caption in the dataset, then in a multilanguage application, you cannot use the multilanguage captions as labels in the report.

Example

In this example, the report has a dataitem based on the Item table. The dataitem has a column No_Item based on the field No. from the Item table, and the caption of this column should be included as a label in the report dataset.

...
dataset
{
    dataitem(Item; Item)
    {
        column(No_Item; "No.")
        {
            IncludeCaption = true;
        }
}

The corresponding label in the dataset will then be called No_ItemCaption.

See Also

Defining a report dataset
Report labels
Caption Property