Log In
Home
Support
Demos
Documentation
Blogs
Training
Webinars
[Expand]General Information
[Collapse]WinForms Controls
  Prerequisites
 [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]Pivot Grid
  [Expand]Tree List
  [Collapse]Chart Control
   [Expand]Getting Started
   [Expand]Fundamentals
   [Expand]Providing Data
   [Expand]Appearance Customization
   [Expand]End-User Features
   [Expand]Design-Time Features
   [Expand]Visual Elements
   [Expand]Examples
   [Collapse]Additional Resources
     Storing the Chart Layout
     Exporting a Chart
     Create a Ribbon Page Category
     Included Components
     Deployment
  [Expand]Diagrams
  [Expand]Gauges
  [Expand]Map Control
  [Expand]Scheduler
  [Expand]Spreadsheet
  [Expand]Rich Text Editor
  [Expand]Spell Checker
  [Expand]Form Layout Managers
  [Expand]Navigation Controls
  [Expand]Printing-Exporting
  [Expand]PDF Viewer
   Reporting
  [Expand]Snap
  [Expand]TreeMap Control
 [Expand]Common Features
  Get More Help
 [Expand]API Reference
[Expand]ASP.NET Controls and MVC Extensions
[Expand]ASP.NET Bootstrap Controls
[Expand]WPF Controls
[Expand]Xamarin Controls
[Expand]Windows 10 App Controls
[Expand]Document Server
[Expand]Reporting
[Expand]Report Server
[Expand]Dashboard
[Expand]eXpressApp Framework
[Expand]CodeRush
[Expand]Cross-Platform Core Libraries
[Expand]Tools and Utilities
 End-User Documentation

Storing the Chart Layout

This document explains how a chart's layout can be saved and restored.

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. And, if a chart is bound to a data source, the information about series data members is included, so that when restoring the layout to another chart, you should simply re-assign it's ChartControl.DataSource property.

Note

We guarantee backward compatibility for a chart layout serialization, meaning that the saved layout will remain fully compatible after migrating to the next XtraCharts version.

You can save and/or restore the layout of your ChartControl or WebChartControl in one of the two following ways.

Expanded Save and Restore the Layout at Design Time

At design time, a chart's layout can be quickly saved to an XML file by clicking the chart's smart tag and choosing Save... in its actions list.

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

Afterwards, click a chart's smart tag and choose Load... in its actions list to restore this layout.

Expanded Save and Restore the Layout at Runtime

At runtime, a chart's layout can be saved either to an XML file or to a memory stream, and then programmatically restored from it. The table below contains methods to store a chart's layout.

Methods used to save and restore a chart, grouped by platforms, are listed below.

Platform Member Description
Windows Forms ChartControl.SaveToFile Saves the chart's layout to the specified file.
ChartControl.SaveToStream Saves the chart's layout to the specified stream.
ChartControl.LoadFromFile Restores the chart's layout from the specified file.
ChartControl.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.

Expanded See Also

How would you rate this topic?​​​​​​​