Xceed Logo
Shop
Xceed DataGrid for WPF v7.3 Documentation
Xceed.Wpf.DataGrid Assembly / Xceed.Wpf.DataGrid Namespace / ColumnBase Class / FieldName Property


In This Topic
    FieldName Property (ColumnBase)
    In This Topic
    Gets or sets the case-sensitive field name that uniquely identifies the Column in a grid's ColumnCollection.
    Syntax
    '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
    ExceptionDescription
    System.InvalidOperationExceptionThrown 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

    See Also

    Reference

    ColumnBase Class
    ColumnBase Members

    Send Feedback