Storing the Chart Layout

  • 3 minutes to read

This topic explains how to save and restore a chart layout.

A chart's layout contains information about the chart's series and other elements, as well as their settings.

If chart series are manually populated with points, the layout also includes information on point arguments and values.

If a chart is bound to a data source, the information about series data members is included. Thus, when you restore the layout to another chart, you should reassign the chart's ASPxDataWebControlBase.DataSource property.

You can save and/or restore the layout of your WebChartControl at design time or runtime.

Save and Restore the Layout at Design Time

At design time, you can can click a chart's smart tag and choose Save... in the invoked Tasks list to save the chart's layout to an XML file.

SaveChart

Then, simply specify the path and name for the XML file.

SaveChartLayout

Next, click the chart's smart tag and select Load... in the invoked Tasks list to restore the layout.

LoadChartLayout

Save and Restore the Layout at Runtime

At runtime, you can save a chart's layout to an XML file or to a memory stream, and restore it programmatically.

The following table lists methods used to save and restore a chart - grouped by platform.

Platform Member Description
ASP.NET WebChartControl.SaveToFile Saves the chart's layout to the specified file.
WebChartControl.SaveToStream Saves the chart's layout to the specified stream.
WebChartControl.LoadFromFile Restores the chart's layout from the specified file.
WebChartControl.LoadFromStream Restores the chart's layout from the specified stream.
ASP.NET MVC ChartControlSettings.SaveToFile Saves the chart's layout to the specified file.
ChartControlSettings.SaveToStream Saves the chart's layout to the specified stream.
ChartControlSettings.LoadFromFile Restores the chart's layout from the specified file.
ChartControlSettings.LoadFromStream Restores the chart's layout from the specified stream.
XtraReports XRChart.SaveToFile Saves the chart's layout to the specified file.
XRChart.SaveToStream Saves the chart's layout to the specified stream.
XRChart.LoadFromFile Restores the chart's layout from the specified file.
XRChart.LoadFromStream Restores the chart's layout from the specified stream.

The following example demonstrates how to save a chart to a memory stream, and then restore it.

using System.IO;
// ...

Stream stream = new MemoryStream();
// ...

// Save the chart.
stream.Seek(0, System.IO.SeekOrigin.Begin);
chartControl1.SaveToStream(stream);

// Load the chart.
stream.Seek(0, System.IO.SeekOrigin.Begin);
chartControl1.LoadFromStream(stream);
See Also