LayoutControl.RestoreLayoutFromXml(String) Method

Restores the layout from the specified XML file.

Namespace: DevExpress.XtraLayout

Assembly: DevExpress.XtraLayout.v19.1.dll

Declaration

C#

public virtual void RestoreLayoutFromXml(
    string xmlFile
)

VB.NET

Public Overridable Sub RestoreLayoutFromXml(
    xmlFile As String
)

Parameters

Name	Type	Description
xmlFile	String	A String value which specifies the path to the XML file that contains the layout to be loaded. If the specified file doesn’t exist, an exception is raised.

Remarks

Use the RestoreLayoutFromXml method to load a layout which has been saved to a file in the XML format using the LayoutControl.SaveLayoutToXml method.

See Save and Restore Layout to learn more.

Example

The code below demonstrates how the layout can be saved to and then restored from an XML file.

C#

string f = "c:\\Layout.xml";
// Save the layout to an XML file.
layoutControl1.SaveLayoutToXml(f);
// ...
// Restore a previously saved layout.
layoutControl1.RestoreLayoutFromXml(f);

VB.NET

Dim f As String = "c:\Layout.xml"
' Save the layout to an XML file.
LayoutControl1.SaveLayoutToXml(f)
' ...
' Restore a previously saved layout.
LayoutControl1.RestoreLayoutFromXml(f)

Related GitHub Examples

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

how-to-change-the-data-source-of-the-datalayoutcontrol-at-runtime-e1901/CS/Q154615/Form1.cs#L45

string layoutPath = GetLayoutPath(dataMember);
if (File.Exists(layoutPath)) layout.RestoreLayoutFromXml(layoutPath);
else layout.ShowCustomizationForm();

how-to-save-a-layout-of-layoutcontrol-together-with-its-child-controls-t131174/CS/WindowsApplication3/Serializer.cs#L66

    }
    layoutControl.RestoreLayoutFromXml(filePath);
}

VB.NET

how-to-change-the-data-source-of-the-datalayoutcontrol-at-runtime-e1901/VB/Q154615/Form1.vb#L50

If File.Exists(layoutPath) Then
    layout.RestoreLayoutFromXml(layoutPath)
Else

how-to-save-a-layout-of-layoutcontrol-together-with-its-child-controls-t131174/VB/WindowsApplication3/Serializer.vb#L61

    Next info
    layoutControl.RestoreLayoutFromXml(filePath)
Catch exc As Exception