Skip to main content

PivotGridOptionsDataField.FieldNaming Property

Gets or sets the rule for naming columns, that correspond to data fields, when creating a data source via the CreateSummaryDataSource methods.

Namespace: DevExpress.XtraPivotGrid

Assembly: DevExpress.PivotGrid.v23.2.Core.dll

NuGet Packages: DevExpress.PivotGrid.Core, DevExpress.Win.Navigation

Declaration

[DefaultValue(DataFieldNaming.FieldName)]
public DataFieldNaming FieldNaming { get; set; }

Property Value

Type Default Description
DevExpress.XtraPivotGrid.DataFieldNaming FieldName

A DevExpress.XtraPivotGrid.DataFieldNaming value that specifies the column naming convention.

Property Paths

You can access this nested property as listed below:

Library Object Type Path to FieldNaming
WinForms Controls PivotGridControl
.OptionsDataField .FieldNaming
Reporting XRPivotGrid
.OptionsDataField .FieldNaming

Remarks

The CreateSummaryDataSource method returns a summary data table which is a two-dimensional representation of data displayed in the PivotGrid control. This summary data table can be used as a data source for regular grid controls, such as the XtraGrid.

The summary data source’s columns that correspond to data fields are named according to the FieldNaming property. If the FieldNaming property is set to FieldName, the columns are named using values of the data fields’ PivotGridFieldBase.FieldName properties.

If there are multiple data fields bound to the same field(s), corresponding columns in the summary data source will have identical names. For the columns to have different names, set the FieldNaming property to Name. In this instance, the columns will be named according to the data fields’ Name properties.

Captions of columns in the summary data source are determined by the PivotGridFieldBase.Caption properties of fields.

See Also