Skip to main content

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)”:

veDataField_1

 

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

veDataField_2

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.

pivotgrid_dataheader

 

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

Characteristics

Members

Field Name

PivotGridField.FieldName

Bound Type

PivotGridFieldBase.UnboundType

Summary Type

PivotGridFieldBase.SummaryType

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

PivotGridOptionsDataField.Caption

Visibility

PivotGridFieldBase.Visible

Column Width

The PivotGridField.Width and PivotGridField.ExportBestFit properties are in effect when the ASPxPivotGrid is exported.

See Also