XRControl.Tag Property

Bindable. Gets or sets the object that contains data about this control.

Namespace: DevExpress.XtraReports.UI

Assembly: DevExpress.XtraReports.v20.2.dll

NuGet Packages: DevExpress.Reporting.Core, DevExpress.WindowsDesktop.Reporting.Core

Declaration

C#

[DefaultValue("")]
[SRCategory(ReportStringId.CatData)]
public virtual object Tag { get; set; }

VB.NET

<SRCategory(ReportStringId.CatData)>
<DefaultValue("")>
Public Overridable Property Tag As Object

Property Value

Type	Default	Description
Object	String.Empty	An Object that contains data about the control.

Remarks

Any type derived from the Object class can be assigned to this property.

A common use for the Tag property is to store data that is closely associated with this control.

Note

The Tag property is bindable, which means that it can be bound to a data field in a report’s data source. To learn more, see the Binding Report Controls to Data section.

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the Tag property.

Note

The algorithm used to collect these code examples remains a work in progress. Accordingly, the links and snippets below may produce inaccurate results. If you encounter an issue with code examples below, please use the feedback form on this page to report the issue.

C#

reporting-winforms-custom-table-of-contents/CS/CustomTableOfContents/CategoriesReport.cs#L15

    XRControl label = sender as XRControl;
    label.Tag = String.Format("Link_{0}", GetCurrentColumnValue("CategoryID"));
}

Reporting_how-to-create-a-drill-through-report-that-supports-backward-navigation-to-a-t455654/CS/ExtendedDrillThroughReport/ProductsReport.cs#L33

private void xrTableCell5_BeforePrint(object sender, System.Drawing.Printing.PrintEventArgs e) {
    ((XRLabel)sender).Tag = GetCurrentRow();
}

Reporting_how-to-implement-an-editor-for-the-xrrichtext-with-dragdrop-from-the-field-list-e526/CS/Form1.cs#L31

    report.Tag = this;
}

Reporting_documentpreviewcontrol-how-to-create-a-drill-down-report-runtime-sample-t337482/CS/dxWPFApp/MainWindow.xaml.cs#L82

masterReport = new XtraReport();
masterReport.Tag = "Master";
masterReport.DataSource = ds;

Reporting_how-to-access-data-values-of-other-labels-in-preview-events-e1154/CS/XtraReport1.cs#L14

private void xrLabel1_BeforePrint(object sender, System.Drawing.Printing.PrintEventArgs e) {
    ((XRLabel)sender).Tag = GetCurrentRow();
}

VB.NET

reporting-winforms-custom-table-of-contents/VB/CustomTableOfContents/CategoriesReport.vb#L17

    Dim label As XRControl = TryCast(sender, XRControl)
    label.Tag = String.Format("Link_{0}", GetCurrentColumnValue("CategoryID"))
End Sub

Reporting_how-to-create-a-drill-through-report-that-supports-backward-navigation-to-a-t455654/VB/ExtendedDrillThroughReport/ProductsReport.vb#L35

Private Sub xrTableCell5_BeforePrint(ByVal sender As Object, ByVal e As System.Drawing.Printing.PrintEventArgs) Handles xrTableCell5.BeforePrint
    DirectCast(sender, XRLabel).Tag = GetCurrentRow()
End Sub

Reporting_how-to-implement-an-editor-for-the-xrrichtext-with-dragdrop-from-the-field-list-e526/VB/Form1.vb#L33

    report.Tag = Me
End Sub

Reporting_documentpreviewcontrol-how-to-create-a-drill-down-report-runtime-sample-t337482/VB/dxWPFApp/MainWindow.xaml.vb#L84

masterReport = New XtraReport()
masterReport.Tag = "Master"
masterReport.DataSource = ds

Reporting_how-to-access-data-values-of-other-labels-in-preview-events-e1154/VB/XtraReport1.vb#L16

Private Sub xrLabel1_BeforePrint(ByVal sender As Object, ByVal e As System.Drawing.Printing.PrintEventArgs) Handles xrLabel1.BeforePrint
    CType(sender, XRLabel).Tag = GetCurrentRow()
End Sub