Skip to main content

DevExpress v24.2 Update — Your Feedback Matters

Our What's New in v24.2 webpage includes product-specific surveys. Your response to our survey questions will help us measure product satisfaction for features released in this major update and help us refine our plans for our next major release.

Take the survey Not interested

RowProperties.FieldName Property

Gets or sets the name of the data source field to bind to a row item.

Namespace: DevExpress.XtraVerticalGrid.Rows

Assembly: DevExpress.XtraVerticalGrid.v24.2.dll

NuGet Packages: DevExpress.Win.Navigation, DevExpress.Win.VerticalGrid

#Declaration

[DefaultValue("")]
[XtraSerializableProperty]
public virtual string FieldName { get; set; }

#Property Value

Type Default Description
String String.Empty

A String value specifying the name of the data field bound to a row.

#Remarks

If your grid control operates in one of its bound modes, it accesses data from the associated data source object. A data source is bound to the grid control with the help of the VGridControl.DataSource and VGridControl.DataMember properties. In this case rows correspond to data source fields. Use the FieldName property to specify the name of the data source field from which a row item should acquire data.

The FieldName property value can also be used as a row item identifier, for instance, in the MultiEditorRowPropertiesCollection.Item property.

If you change this property at runtime to bind a row item to another data field, ensure to update the row item caption as well. For this purpose, set the RowProperties.Caption property to the appropriate value which describes data represented by the bound field.

When working in Unbound Mode the grid control has no data source associated with it. In this case, the FieldName property is not in effect. Each row (row item) in this mode has a single data cell whose initial value can be set via the RowProperties.Value property.

The find panel searches for a row by its caption, tooltip, field name, and caption in the customization form. The SearchTags property allows you to provide custom tags by which the find panel can find this row.

See Also