Skip to main content

PivotGridControl.SaveLayoutToXml(String) Method

Saves a Pivot Grid Control’s layout to an XML file.

Namespace: DevExpress.XtraPivotGrid

Assembly: DevExpress.XtraPivotGrid.v24.1.dll

NuGet Package: DevExpress.Win.PivotGrid


public void SaveLayoutToXml(
    string xmlFile


Name Type Description
xmlFile String

A string value specifying the path to the file where a Pivot Grid Control’s layout should be stored. If an empty string is specified, an exception is raised.


Use the SaveLayoutToXml method to save a Pivot Grid Control’s layout to a specific XML file at runtime. The saved settings can then be restored using the PivotGridControl.RestoreLayoutFromXml method.

Note that you should specify unique names for all pivot grid fields to correctly save and restore the layout. You can do this using the PivotGridFieldBase.Name property.

The PivotGridControl.OptionsLayout property controls which settings should be saved to the file.


The expansion states of field values are not saved by the SaveLayoutToXml method.


You can utilize the Persistence Behavior or Workspace Manager component to save and restore layouts for all supported DevExpress controls at once.


The code below demonstrates how the Pivot Grid Control’s layout can be saved to and then restored from an XML file.

string fileName = "c:\\XtraPivotGrid_Layout.xml";
// Saves layout to an XML file.

// ...
// Restores the previously saved layout.
See Also