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.
Then, simply specify the path and name for the XML file.
Next, click the chart’s smart tag and select Load… in the invoked Tasks list to restore the layout.
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);