LayoutControl.ReadFromXML(XmlReader) Method

Restores the layout of child items that have been previously saved via the LayoutControlBase.WriteToXML method. The method optimizes the layout after loading (removes empty and unnecessary groups) without visually breaking the layout.

Namespace: DevExpress.Xpf.LayoutControl

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

NuGet Packages: DevExpress.WindowsDesktop.Wpf.LayoutControl, DevExpress.Wpf.Layout

Declaration

C#

public override void ReadFromXML(
    XmlReader xml
)

VB.NET

Public Overrides Sub ReadFromXML(
    xml As XmlReader
)

Parameters

Name	Type	Description
xml	XmlReader	An XmlReader object from which data is read.

Remarks

You can save the layout of child items via the LayoutControlBase.WriteToXML method. The ReadFromXML method allows you to load the previously saved layout.

Note

To correctly save and then restore the layout of items, you need to assign names to the items. If names are not specified, the layout will be correctly restored, provided that the LayoutControl’s/LayoutGroup’s item collection (the order and number of items) wasn’t modified after the layout was saved.

To load a layout, we recommend using the Loaded event of a UserControl or a window.

Example

The following example shows how to save the layout of items of a LayoutControl object to a stream, and then restore the layout. The LayoutControlBase.WriteToXML and LayoutControl.ReadFromXML methods are used to do this.

C#

using System.Xml;
using System.IO;

MemoryStream stream = new MemoryStream();

//Save the layout
XmlWriter writer = XmlWriter.Create(stream);
myLayoutControl.WriteToXML(writer);
writer.Close();

//Load the layout
stream.Seek(0, SeekOrigin.Begin);
XmlReader reader = XmlReader.Create(stream);
myLayoutControl.ReadFromXML(reader);
reader.Close();