[Expand]General Information
[Collapse]WinForms Controls
  .NET Core Support
 [Expand]What's Installed
 [Expand]Build an Application
 [Collapse]Controls and Libraries
  [Expand]Forms and User Controls
  [Expand]Messages, Notifications, and Dialogs
  [Expand]Editors and Simple Controls
  [Expand]Ribbon, Bars and Menu
  [Expand]Application UI Manager
  [Expand]Docking Library
  [Expand]Data Grid
  [Expand]Vertical Grid
  [Expand]Property Grid
  [Collapse]Pivot Grid
   [Expand]Getting Started
   [Expand]Binding to Data
   [Expand]Data Shaping
   [Expand]Data Analysis
   [Expand]Focus and Navigation
   [Expand]Printing and Exporting
   [Expand]Design-Time Features
   [Collapse]UI Elements
     Column Field
     Column Header Area
     Data Area
     Data Field
     Data Field Summary Change Menu
     Data Header Area
     Empty Area
     Expand Button
     Field Header
     Field Header Context Menu
     Field Value
     Field Value Context Menu
     Filter Button and Popup
     Filter Field
     Filter Header Area
     Filter Header Area Separator
     Grand Totals
     Header Area
     Header Area Context Menu
     Filter Panel
     MRU (Most Recently Used) Filter List
     Row Field
     Row Header Area
     Summary Filter Popup Window
   [Expand]End-User Capabilities
   [Expand]Member Tables
  [Expand]Tree List
  [Expand]Gantt Control
  [Expand]Chart Control
  [Expand]Map Control
  [Expand]Rich Text Editor
  [Expand]Spell Checker
  [Expand]Form Layout Managers
  [Expand]Navigation Controls
  [Expand]PDF Viewer
  [Expand]TreeMap Control
  [Expand]Sunburst Control
 [Expand]Common Features
  Get More Help
 [Expand]API Reference
[Expand]ASP.NET Controls and MVC Extensions
[Expand]ASP.NET Bootstrap Controls
[Expand]ASP.NET Core Bootstrap Controls
[Expand]WPF Controls
[Expand]Xamarin Controls
[Expand]Windows 10 App Controls
[Expand]Office File API
[Expand]Report and Dashboard Server
[Expand]eXpressApp Framework
[Expand]eXpress Persistent Objects
[Expand]CodeRush Classic
[Expand]Cross-Platform Core Libraries
[Expand]Tools and Utilities
 End-User Documentation
View this topic on docs.devexpress.com (Learn more)

Data Field

Data fields represent fields located in a Pivot Grid Control's Data Header Area. PivotGridControl calculates summaries against data fields and summary results 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 the entire population, Variation based on a sample and Variation based on the entire population.

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


The following image shows a sample PivotGrid control that contains one data field - "Quantity(Sum)":

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

By default, data field headers are listed along a control's top edge. It is possible to display the data field headers along the control's left edge 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 is a header that is linked with data field headers. It can be dragged to a specific position within a column header area or row header area and as a result, data field headers will be moved to the associated location.


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

Field Name


Bound Type


Summary Type




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

Size of Data Field Headers




Column Width



The PivotGridControl.FieldWidthChanged event provides a notification that the field width has been changed.

Caption of the Data Header




Linking with Other Fields


Expanded See Also

Is this topic helpful?​​​​​​​