FieldName Property (ColumnBase)

Gets or sets the case-sensitive field name that uniquely identifies the Column in a grid's ColumnCollection.

Syntax

Visual Basic
C#

'Declaration
 
Public Property FieldName As String

'Usage
 
Dim instance As ColumnBase
Dim value As String
 
instance.FieldName = value
 
value = instance.FieldName

public string FieldName {get; set;}

Property Value

A string representing the field name that uniquely identifies the Column in a grid's ColumnCollection. By default, this is a null reference (Nothing in Visual Basic).

Exceptions

Exception	Description
System.InvalidOperationException	Thrown when the Column's FieldName property is set after the Column has been added to a grid's ColumnCollection.

Remarks

Note that when sorting and/or grouping data items, the name of the data item's property and the value of the FieldName property must be identical; otherwise, neither sorting nor grouping will work.

Also note that since version 6.7 of the DataGrid, a Column's FieldName cannot & should not be changed once it is set.

Requirements

Target Platforms: Windows 11, Windows, 10, Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

Reference

ColumnBase Class
ColumnBase Members