Back to Devexpress

WorkspaceManager.CloseStreamOnWorkspaceSaving Property

windowsforms-devexpress-dot-utils-dot-workspacemanager-8d7774be.md

latest4.3 KB
Original Source

WorkspaceManager.CloseStreamOnWorkspaceSaving Property

Gets or sets whether this WorkspaceManager should automatically close streams opened when saving workspaces.

Namespace : DevExpress.Utils

Assembly : DevExpress.Utils.v25.2.dll

NuGet Packages : DevExpress.Utils, DevExpress.Wpf.Core

Declaration

csharp
[DefaultValue(DefaultBoolean.Default)]
[DXCategory("Behavior")]
public DefaultBoolean CloseStreamOnWorkspaceSaving { get; set; }
vb
<DXCategory("Behavior")>
<DefaultValue(DefaultBoolean.Default)>
Public Property CloseStreamOnWorkspaceSaving As DefaultBoolean

Property Value

TypeDefaultDescription
DefaultBooleanDefault

A DefaultBoolean enumerator value that specifies whether this WorkspaceManager should automatically close streams opened when saving workspaces.

|

Available values:

NameDescriptionReturn Value
True

The value is true.

|

0

| | False |

The value is false.

|

1

| | Default |

The value is specified by a global option or a higher-level object.

|

2

|

Remarks

Each time the WorkspaceManager saves (WorkspaceManager.SaveWorkspace) or loads (WorkspaceManager.LoadWorkspace) a workspace, it opens a stream to work with an XML file. By default, these streams are not closed automatically and stay in memory, which can cause performance issues when working with large workspaces. To force the WorkspaceManager to close these streams, set the CloseStreamOnWorkspaceSaving and WorkspaceManager.CloseStreamOnWorkspaceLoading properties to DefaultBoolean.True.

The following code snippet (auto-collected from DevExpress Examples) contains a reference to the CloseStreamOnWorkspaceSaving property.

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.

winforms-workspacemanager-saving-load-app-layout/CS/T190543/Form1.cs#L42

csharp
this.workspaceManager1.CloseStreamOnWorkspaceSaving = DevExpress.Utils.DefaultBoolean.True;
this.workspaceManager1.CloseStreamOnWorkspaceLoading = DevExpress.Utils.DefaultBoolean.True;

winforms-workspacemanager-saving-load-app-layout/VB/T190543/Form1.vb#L41

vb
selectWorkSpaceItem.EditValue = "Default"
workspaceManager1.CloseStreamOnWorkspaceSaving = DevExpress.Utils.DefaultBoolean.True
workspaceManager1.CloseStreamOnWorkspaceLoading = DevExpress.Utils.DefaultBoolean.True

See Also

SaveWorkspace

LoadWorkspace

CloseStreamOnWorkspaceSaving

WorkspaceManager Class

WorkspaceManager Members

DevExpress.Utils Namespace