XtraReport.SaveLayout(String) Method

Saves the report’s definition (layout and configuration) to a file in the REPX format.

Namespace: DevExpress.XtraReports.UI

Assembly: DevExpress.XtraReports.v18.2.dll

Declaration

C#

public void SaveLayout(
    string fileName
)

VB.NET

Public Sub SaveLayout(
    fileName As String
)

Parameters

Name	Type	Description
fileName	String	A String containing the full path (including the file name) specifying where the report’s definition will be saved.

Remarks

A report definition contains all report settings, as well as settings of report controls. To load the report’s definition from a REPX file, use the XtraReport.LoadLayout and XtraReport.FromFile methods.

Alternatively, to save a report definition in an XML format, use the XtraReport.SaveLayoutToXml.

To learn more, see Storing Report Layouts.

Example

This example demonstrates how to save a report definition to a REPX file (by using the XtraReport.SaveLayout method) and how to load this definition (by using the XtraReport.LoadLayout method).

C#

using DevExpress.XtraReports.UI;
using System.Windows.Forms;
// ...

// A temporary path to save a report to.
string filePath = @"C:\Temp\XtraReport1.repx";

private void button1_Click(object sender, System.EventArgs e) {
    // Create a report.
    XtraReport1 report = new XtraReport1();

    // Save a report's layout to the configuration file.
    report.SaveLayout(filePath);
}

private void button2_Click(object sender, System.EventArgs e) {
    // Create a report.
    XtraReport1 report = new XtraReport1();

    // Load a report's layout from the specified file.
    report.LoadLayout(filePath);

    // Display the print preview.
    ReportPrintTool pt = new ReportPrintTool(report);
    pt.ShowPreviewDialog();
}

VB.NET

Imports DevExpress.XtraReports.UI
Imports System.Windows.Forms
' ...

' A temporary path to save a report to.
Dim FilePath As String = "C:\Temp\XtraReport1.repx" 

Private  Sub OnButton1Click(ByVal sender As Object, ByVal e As System.EventArgs) _
Handles Button1.Click
    ' Create a report.
    Dim Report As XtraReport1 =  New XtraReport1() 

    ' Save a report's layout to the configuration file.
    Report.SaveLayout(FilePath)
End Sub

Private  Sub OnButton2Click(ByVal sender As Object, ByVal e As System.EventArgs) _
Handles Button2.Click
    ' Create a report.
    Dim Report As XtraReport1 =  New XtraReport1() 

    ' Load a report's layout from the specified file.
    Report.LoadLayout(FilePath)

    ' Display the print preview.
    Dim pt As New ReportPrintTool(report)
    pt.ShowPreviewDialog()
End Sub

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the SaveLayout(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.

C#

Reporting_how-to-bind-a-report-to-express-persistent-objects-xpo-e1845/CS/XpoXtraReports/Form1.cs#L51

    OrderDocument od = new OrderDocument();
    od.SaveLayout("Report.repx");
}

Reporting_how-to-save-load-a-report-definition-from-a-file-e1279/CS/SaveLoadDefinition/Form1.cs#L20

    // Save the report's layout to the configuration file.
    report.SaveLayout(filePathCodeDom);
}

Reporting_winforms-end-user-designer-how-to-override-commands-implement-custom-saving-e4354/CS/CustomSavingEUD/Form1.cs#L71

// For instance:
panel.Report.SaveLayout("c:\\report1.repx");

Reporting_how-to-invoke-the-report-wizard-to-create-a-report-at-runtime-e93/CS/Form1.cs#L27

form.DesignMdiController.CreateNewReportWizard();
form.ActiveDesignPanel.BeginInvoke(new MethodInvoker(() => { form.ActiveDesignPanel.Report.SaveLayout(fileName); }));
return fileName;

VB.NET

Reporting_how-to-bind-a-report-to-express-persistent-objects-xpo-e1845/VB/XpoXtraReports/Form1.vb#L48

    Dim od As New OrderDocument()
    od.SaveLayout("Report.repx")
End Sub

Reporting_how-to-save-load-a-report-definition-from-a-file-e1279/VB/SaveLoadDefinition/Form1.vb#L22

    ' Save the report's layout to the configuration file.
    report.SaveLayout(filePathCodeDom)
End Sub

Reporting_winforms-end-user-designer-how-to-override-commands-implement-custom-saving-e4354/VB/CustomSavingEUD/Form1.vb#L69

' For instance:
panel.Report.SaveLayout("c:\report1.repx")

Reporting_how-to-invoke-the-report-wizard-to-create-a-report-at-runtime-e93/VB/Form1.vb#L25

form.DesignMdiController.CreateNewReportWizard()
form.ActiveDesignPanel.BeginInvoke(New MethodInvoker(Sub() form.ActiveDesignPanel.Report.SaveLayout(fileName)))
Return fileName