Data Field
- 2 minutes to read
Data fields represent fields located in a pivot grid’s Data Header Area. The 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 on a sample, Standard Deviation based on an entire population, Variation based on a sample and Variation based on an entire population.
For non-numeric data fields, the following summary functions are available: Count, Min and Max.
The following image shows an ASPxPivotGrid control that contains one data field - “Quantity(Sum)”:
When there are two or more data fields, the ASPxPivotGrid displays data field headers to distinguish between different summary values.
By default, data field headers are listed along the top of the control. It is possible to display data field headers along the left side of the control 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 the field’s functionality.
Characteristics | Members |
|---|---|
Field Name | |
Bound Type | |
Summary Type | |
Position | PivotGridFieldBase.Area, PivotGridFieldBase.AreaIndex For data fields, the PivotGridFieldBase.Area property is set to PivotArea.DataArea. |
Position of Data Field Headers | PivotGridOptionsDataField.Area, PivotGridOptionsDataField.AreaIndex |
Caption of the Data Header | |
Visibility | |
Column Width | The PivotGridField.Width and PivotGridField.ExportBestFit properties are in effect when the ASPxPivotGrid is exported. |