Skip to main content

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.1.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