FieldName Property (ColumnBase)

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

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 column collection. By default, a null reference (Nothing in Visual Basic).

Exceptions

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

Remarks

When sorting and/or grouping data items, the name of the property in the data item and the value of the FieldName property must be identical otherwise neither sorting nor grouping will work.

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