Data Field
- 2 minutes 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)”:
When there are two or more data fields, the pivot grid displays data field headers to distinguish between different summary values.
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.
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) |