Data Field

  • 2 min to read

Data fields represent fields located in a pivot grid's Data Header Area. Pivot Grid calculates summaries against data fields. Summary results are displayed within the Data Area.

For numeric data fields, the following summary functions can be calculated: Sum, Count, Min, Max, Average, Standard Deviation based upon a sample, Standard Deviation based upon an entire population, Variation based upon a sample and Variation based upon an entire population.

For non-numeric data fields, the following summary functions are available: Count, Min and Max.

 

The following image shows a PivotGrid, which contains one data field - "Quantity(Sum)":

veDataField_1

 

When there are two or more data fields, the pivot grid displays data field headers to distinguish between different summary values.

veDataField_2

By default, data field headers are listed along the control's top. It is possible to display data field headers along the control's left by setting the PivotGridOptionsDataField.Area property to PivotDataArea.RowArea. The PivotGridOptionsDataField.AreaIndex property specifies the position of the data field headers within the hierarchy of field values.

Setting the PivotGridOptionsDataField.Area property to PivotDataArea.ColumnArea or PivotDataArea.RowArea enables the data header. This header is linked with data field headers. It can be dragged to a specific position within a column header area or row header area, and data field headers will be moved to the associated location.

pivotgrid_dataheader

 

The table below lists the main properties that affect field functionality.

Characteristics

Members

Field Name

PivotGridField.FieldName (via MVCxPivotGridField.FieldName)

Bound Type

PivotGridFieldBase.UnboundType (via MVCxPivotGridField.UnboundType)

Summary Type

PivotGridFieldBase.SummaryType (via MVCxPivotGridField.SummaryType)

Position

PivotGridFieldBase.Area (via MVCxPivotGridField.Area)

PivotGridFieldBase.AreaIndex (via MVCxPivotGridField.AreaIndex)

For data fields, the PivotGridFieldBase.Area property is set to PivotArea.DataArea.

Position of Data Field Headers

PivotGridOptionsDataField.Area (via PivotGridSettings.OptionsDataField.Area)

PivotGridOptionsDataField.AreaIndex (via PivotGridSettings.OptionsDataField.AreaIndex)

Caption of the Data Header

PivotGridOptionsDataField.Caption (via PivotGridSettings.OptionsDataField.Caption)

Visibility

PivotGridFieldBase.Visible (via MVCxPivotGridField.Visible)

See Also