ChartControl.SaveToFile(String) Method

Saves a chart layout to the specified file.

Namespace: DevExpress.Xpf.Charts

Assembly: DevExpress.Xpf.Charts.v20.2.dll

NuGet Packages: DevExpress.WindowsDesktop.Wpf.Charts, DevExpress.Wpf.Charts

Declaration

C#

public void SaveToFile(
    string fileName
)

VB.NET

Public Sub SaveToFile(
    fileName As String
)

Parameters

Name	Type	Description
fileName	String	The path to the file where a layout is stored. An exception is raised if an empty string is specified.

Remarks

The SaveToFile method saves a chart layout (chart settings, information about series, etc.) to a file. Use the ChartControl.LoadFromFile method to restore the saved data from this file.

Example

The following code uses the ChartControl.SaveToFile method to save the chart layout to a file, and the ChartControl.LoadFromFile method to restore the layout from a file:

View Example

C#

// In the Window's code-behind file.
const string LayoutSavedFormatString = "The Chart Layout saved to the '{0}' file";
const string LayoutLoadedFormatString = "The Chart Layout loaded from the '{0}' file";

private void OnSaveBarItemClick(object sender, ItemClickEventArgs e) {
    DXSaveFileDialog dialog = new DXSaveFileDialog();
    dialog.DefaultExt = "xml";
    bool? result = dialog.ShowDialog();
    if (result.HasValue && result.Value) {
        chartControl.SaveToFile(dialog.FileName);
        statusMessageItem.Content = String.Format(LayoutSavedFormatString, dialog.FileName);
    }
}

private void OnLoadBarItemClick(object sender, ItemClickEventArgs e) {
    DXOpenFileDialog dialog = new DXOpenFileDialog();
    dialog.DefaultExt = "xml";
    bool? result = dialog.ShowDialog();
    if (result.HasValue && result.Value) {
        chartControl.LoadFromFile(dialog.FileName);
        // IMPORTANT: LoadFrom... methods create new instances of chart elements to restore the Chart Control's layout.
        // You should recreate bindings if you bind UI controls to chart elements.
        CreateBindings();
        statusMessageItem.Content = String.Format(LayoutLoadedFormatString, dialog.FileName);
    }
}

VB

' In the Window's code-behind file.
Const LayoutSavedFormatString As String = "The Chart Layout saved to the '{0}' file"
Const LayoutLoadedFormatString As String = "The Chart Layout loaded from the '{0}' file"

Private Sub OnSaveBarItemClick(sender As Object, e As ItemClickEventArgs)
    Dim dialog As DXSaveFileDialog = New DXSaveFileDialog()
    dialog.DefaultExt = "xml"
    Dim result As Boolean? = dialog.ShowDialog()
    If (result.HasValue And result.Value) Then
        chartControl.SaveToFile(dialog.FileName)
        statusMessageItem.Content = String.Format(LayoutSavedFormatString, dialog.FileName)
    End If
End Sub

Private Sub OnLoadBarItemClick(sender As Object, e As ItemClickEventArgs)
    Dim dialog As DXOpenFileDialog = New DXOpenFileDialog()
    dialog.DefaultExt = "xml"
    Dim result As Boolean? = dialog.ShowDialog()
    If (result.HasValue And result.Value) Then
        chartControl.LoadFromFile(dialog.FileName)
        ' IMPORTANT: LoadFrom... methods create new instances of chart elements to restore the Chart Control's layout.
        ' You should recreate bindings when you bind UI controls to chart elements.
        CreateBindings()
        statusMessageItem.Content = String.Format(LayoutLoadedFormatString, dialog.FileName)
    End If
End Sub

Related GitHub Examples

The following code snippet (auto-collected from DevExpress Examples) contains a reference to the SaveToFile(String) method.

Note

The algorithm used to collect these code examples remains a work in progress. Accordingly, the links and snippets below may produce inaccurate results. If you encounter an issue with code examples below, please use the feedback form on this page to report the issue.

VB.NET

how-to-save-and-restore-chart-layout/VB/SaveLayoutSample/MainWindow.xaml.vb#L27

If result.HasValue AndAlso result.Value Then
    chartControl.SaveToFile(dialog.FileName)
    statusMessageItem.Content = String.Format(LayoutSavedFormatString, dialog.FileName)