XRControl.Name Property

Gets or sets a name of the control.

Namespace: DevExpress.XtraReports.UI

Assembly: DevExpress.XtraReports.v19.1.dll

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

Declaration

C#

[Browsable(false)]
[DefaultValue("")]
public string Name { get; set; }

VB.NET

<DefaultValue("")>
<Browsable(False)>
Public Property Name As String

Property Value

Type	Default	Description
String	String.Empty	A String containing a name of the control.

Remarks

The Name property can be used at runtime to evaluate an object by its name rather than type and programmatic name. Because the Name property returns a String value, it can be evaluated in case-style logic statements (switch statement in C#, Select statement in Visual Basic).

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the Name 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_how-to-use-the-web-document-viewer-in-javascript-with-reactjs-t561300/CS/ServerSide/XtraReport2.cs#L124

this.topMarginBand1.HeightF = 100F;
this.topMarginBand1.Name = "topMarginBand1";
//

Reporting_how-to-use-the-web-report-designer-in-javascript-with-reactjs-t561295/CS/ServerSide/XtraReport1.cs#L130

this.topMarginBand1.HeightF = 100F;
this.topMarginBand1.Name = "topMarginBand1";
//

Reporting_embedded-end-user-report-designer-demonstration-e20017/CS/Contacts/Reports/CategoryReportService.cs#L17

CategoryReport r = new CategoryReport();
r.Name = string.Format("CategoryReport{0}", _counter);
r.DisplayName = r.Name;

Reporting_how-to-check-which-control-initiates-creating-extra-empty-pages-after-every-page-in-e2338/CS/Form1.cs#L65

VisualBrick vb = be.Current as VisualBrick;
ReportControlDescriptor mo = new ReportControlDescriptor(((XRControl)vb.BrickOwner).Name, ((XRControl)vb.BrickOwner).Report.ToString());
if (!controls.ContainsKey(mo.FullName))

Reporting_how-to-dynamically-group-a-report-based-on-a-parameter-value-t317198/CS/WindowsFormsApplication1/XtraReport1.cs#L21

groupHeader.Height = 20;
groupHeader.Name = "groupHeader" + i;
string field = ((string[])parameterMultiGroupField.Value)[i];

VB.NET

Reporting_how-to-use-the-web-document-viewer-in-javascript-with-reactjs-t561300/VB/ServerSide/XtraReport2.vb#L125

Me.topMarginBand1.HeightF = 100F
Me.topMarginBand1.Name = "topMarginBand1"
'

Reporting_how-to-use-the-web-report-designer-in-javascript-with-reactjs-t561295/VB/ServerSide/XtraReport1.vb#L131

Me.topMarginBand1.HeightF = 100F
Me.topMarginBand1.Name = "topMarginBand1"
'

Reporting_embedded-end-user-report-designer-demonstration-e20017/VB/Contacts/Reports/PersonReportService.vb#L16

Dim r As New PersonReport()
r.Name = String.Format("PersonReport{0}", _counter)
r.DisplayName = r.Name

Reporting_how-to-check-which-control-initiates-creating-extra-empty-pages-after-every-page-in-e2338/VB/Form1.vb#L69

Dim vb As VisualBrick = TryCast(be.Current, VisualBrick)
Dim mo As New ReportControlDescriptor(CType(vb.BrickOwner, XRControl).Name, CType(vb.BrickOwner, XRControl).Report.ToString())
If Not controls_Renamed.ContainsKey(mo.FullName) Then

Reporting_how-to-dynamically-group-a-report-based-on-a-parameter-value-t317198/VB/WindowsFormsApplication1/XtraReport1.vb#L24

groupHeader.Height = 20
groupHeader.Name = "groupHeader" & i
Dim field As String = DirectCast(parameterMultiGroupField.Value, String())(i)

Implements

DevExpress.XtraPrinting.IBrickOwner.Name