• Article

Stream.Dispose Method (Boolean)

Microsoft Silverlight will reach end of support after October 2021. Learn more.

Releases the unmanaged resources used by the Stream and optionally releases the managed resources.

Namespace:  System.IO
Assembly:  mscorlib (in mscorlib.dll)

Syntax

'Declaration
Protected Overridable Sub Dispose ( _
    disposing As Boolean _
)

protected virtual void Dispose(
    bool disposing
)

Parameters

  • disposing
    Type: System.Boolean
    true to release both managed and unmanaged resources; false to release only unmanaged resources.

Remarks

You should release all resources by specifying true for disposing. When disposing is true, the stream can also ensure data is flushed to the underlying buffer, and access other finalizable objects. This may not be possible when called from a finalizer due a lack of ordering among finalizers.

This method is called by the Finalize method. Finalize invokes Dispose with disposing set to false.

Notes to Inheritors

In derived classes, do not override the Close method, instead, put all of the Stream cleanup logic in the Dispose method.

Version Information

Silverlight

Supported in: 5, 4, 3

Silverlight for Windows Phone

Supported in: Windows Phone OS 7.1, Windows Phone OS 7.0

XNA Framework

Supported in: Xbox 360, Windows Phone OS 7.0

Platforms

For a list of the operating systems and browsers that are supported by Silverlight, see Supported Operating Systems and Browsers.