DockManager.RestoreLayoutFromStream(Stream) Method

Restores the layout of dock panels from the specified stream.

Namespace: DevExpress.XtraBars.Docking

Assembly: DevExpress.XtraBars.v19.1.dll

Declaration

C#

public virtual void RestoreLayoutFromStream(
    Stream stream
)

VB.NET

Public Overridable Sub RestoreLayoutFromStream(
    stream As Stream
)

Parameters

Name	Type	Description
stream	Stream	A Stream descendant from which the dock panels’ settings are read. If null (Nothing in Visual Basic), an exception is raised.

Remarks

Note

When restoring a layout during a form load (for instance, in your Form.Load event handler), you may need to call the DockManager.ForceInitialize method prior to the layout restoration. See this method to learn more.

For more information, see Saving and Restoring the Layout of Dock Panels

Example

The following code demonstrates how to write and read the docking layout to and from memory.

C#

System.IO.Stream stream = new System.IO.MemoryStream();
dockManager1.SaveLayoutToStream(stream);
// Set the stream pointer to the beginning.
stream.Seek(0, System.IO.SeekOrigin.Begin);

// ...

dockManager1.RestoreLayoutFromStream(stream);
// Set the stream pointer to the beginning.
stream.Seek(0, System.IO.SeekOrigin.Begin);

VB.NET

Dim stream As System.IO.Stream
stream = New System.IO.MemoryStream()
DockManager1.SaveToStream(stream)
' Set the stream pointer to the beginning.
stream.Seek(0, System.IO.SeekOrigin.Begin)

' ...

DockManager1.RestoreFromStream(stream)
' Set the stream pointer to the beginning.
stream.Seek(0, System.IO.SeekOrigin.Begin)

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the RestoreLayoutFromStream(Stream) 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-save-several-layouts-into-one-file-t113942/CS/NewProject/Form1.cs#L66

dockManager1.RestoreLayoutFromStream(new MemoryStream(dockManagerLayout.Data));
tabbedView1.RestoreLayoutFromStream(new MemoryStream(tabbedViewLayout.Data));

VB.NET

how-to-save-several-layouts-into-one-file-t113942/VB/NewProject/Form1.vb#L58

dockManager1.RestoreLayoutFromStream(New MemoryStream(dockManagerLayout.Data))
tabbedView1.RestoreLayoutFromStream(New MemoryStream(tabbedViewLayout.Data))

XAF_how-to-create-information-panels-e2690/VB/InfoPanels.Module.Win/MainForm.vb#L66

    Dim stream As MemoryStream = New MemoryStream(Encoding.UTF8.GetBytes(ModelTemplate.DockManagerSettings))
    DockManager.RestoreLayoutFromStream(stream)
End If