[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
   [Collapse]Printing and Exporting
   [Expand]Design-Time Features
   [Expand]UI Elements
   [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)


The Pivot Grid control allows you to export Pivot Grid data to a file or stream in various formats - HTML, MHT, PDF, RTF, TXT, CSV, XLS or XLSX. When you export, you copy data from a pivot grid into a new file formatted for use in another application. This document describes exporting in detail.

To export pivot grid data, use one of the following export methods.

Output Format Methods Data-Aware Support Description
HTML PivotGridControl.ExportToHtml n/a Exports Pivot Grid data to the specified file in an HTML format using the specified character encoding.
MHT PivotGridControl.ExportToMht n/a Exports Pivot Grid data to the specified file in an MHT format using the specified character encoding with the specified title. The output file can be compressed (secondary characters such as spaces are removed) if required.
PDF PivotGridControl.ExportToPdf n/a Exports Pivot Grid data to the specified file as a PDF.
RTF PivotGridControl.ExportToRtf n/a Exports Pivot Grid data to the specified file as a RTF.
DOCX PivotGridControl.ExportToDocx n/a Exports Pivot Grid data to the specified file in a DOCX format.
TXT PivotGridControl.ExportToText n/a Exports Pivot Grid data to the specified file in a TXT format using the specified separator string and encoding settings.
CSV PivotGridControl.ExportToCsv Exports the Pivot Grid data to the specified file in a CSV format.
XLS PivotGridControl.ExportToXls Exports Pivot Grid data to the specified file in an XLS format.
XLSX PivotGridControl.ExportToXlsx Exports Pivot Grid data to the specified file in an XLSX (MS Excel 2007) format.

Export settings can be customized when calling the ExportTo... method overloads that take an options parameter. This parameter can be specified with a descendant of the ExportOptionsBase class, which defines how a document is exported to a specific format.


Results of custom drawing and images cannot be exported.

Expanded Export Modes

Two export modes are supported when exporting data from a Pivot Grid control to table formats (*.xls(x), *.csv).

  • Data-aware Export - The export mode, optimized for subsequent analysis of pivot grid data within Microsoft Excel. Various data shaping options that are applied within the pivot grid are retained in the output XLS(X) and CSV documents.
  • WYSIWYG Export - In this export mode, the layout of pivot grid cells is retained in resulting XLS(X) and CSV documents. Specific data shaping options are not retained compared to data-aware export.

Data exported using other formats (PDF, RTF, TXT, etc.) is always exported in the WYSIWYG mode.

Choosing Export Mode

You can specify export mode in two ways.

  • Set the static ExportSettings.DefaultExportType property that allows you to choose the required export mode used by default by all XLS(X) and CSV export methods.

  • Specify export mode with each call of the XLS(X) or CSV export methods (when using these method overloads with an options parameter). Create an PivotXlsExportOptions object (or PivotXlsxExportOptions, CsvExportOptionsEx objects), set its ExportType property and pass this object to the XLS(X)/CSV export method.

Expanded Data-Aware Export

Data-aware is the default export mode for XLS and XLSX formats, and is optimized for subsequent analysis of pivot grid data within Microsoft Excel.

The following data shaping options, which are applied within the pivot grid control, are retained in the output XLS-XLSX documents.

  • Data Grouping - with the capability to collapse/expand groups within a worksheet.
  • Fixed Columns – allow column and row areas to stay in sight.
  • Cell Formatting – allows you to export the number format.
  • Display Text/Value export - allows you to select whether to export display text or values.

Data-Aware Export Settings

A few options that are inherited by the XlsExportOptionsEx and XlsxExportOptionsEx classes from their base class are not supported by the data-aware export engine. The options supported in data-aware mode are listed in the following table.




Gets or sets the name of a sheet in a created XLS file to which a document is exported.



Gets or sets whether or not the row area in a pivot grid control is fixed in the exported document.



Gets or sets whether the column area is anchored to the top of the export document, and thus is not scrolled vertically.



Gets or sets whether or not data groups are exported from the source control to the output document.



Gets or sets whether or not a title is displayed for each print preview page of the exported document.

PivotXlsExportOptionsBase.ExportColumnAreaHeaders, PivotXlsxExportOptionsBase.ExportColumnAreaHeaders

Gets or sets whether to include the column field headers in the exported document.

PivotXlsExportOptionsBase.ExportDataAreaHeaders, PivotXlsxExportOptionsBase.ExportDataAreaHeaders

Gets or sets whether to include the data field headers in the exported document.

PivotXlsExportOptionsBase.ExportFilterAreaHeaders, PivotXlsxExportOptionsBase.ExportFilterAreaHeaders

Gets or sets whether to include the filter field headers in the exported document.

PivotXlsExportOptionsBase.ExportRowAreaHeaders, PivotXlsxExportOptionsBase.ExportRowAreaHeaders

Gets or sets whether to include the row field headers in the exported document.

XlsExportOptionsEx.ExportType, XlsxExportOptionsEx.ExportType

Gets or sets export mode. You can specify the WYSIWYG or data-aware export mode.

XlsExportOptionsEx.GroupState, XlsxExportOptionsEx.GroupState

Gets or sets whether groups will be collapsed or expanded in the exported document.


Enables the export mode, which when used, exports only a report's actual data to XLS(X). Note that options like XlsExportOptionsEx.AllowGrouping and XlsxExportOptionsEx.AllowGrouping are disabled and not in effect in the exported document. Note that the parent cell values in the exported document are exported for every child cell value when the RawDataMode property is set to true.


Gets or sets a value indicating whether the cells in the resulting XLS(X) document should use the same formatting as the original document.

You can customize a PivotGrid's cell in the exported XLS or XLSX document using the PivotXlsExportOptions.CustomizeCell and PivotXlsxExportOptions.CustomizeCell events. Use the CustomizePivotCellEventArgs.RowType and CustomizePivotCellEventArgs.ColumnType parameters to identify a row and column containing the cell. To specify cell location in the exported Excel document, use the CustomizePivotCellEventArgs.ExportArea property. To customize the cell format, use the CustomizePivotCellEventArgs.Formatting property.


Set the CustomizePivotCellEventArgs.Handled parameter to true to export cells with custom formatting.

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