• Article

CancellationTokenRegistration.Dispose Method

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

Releases all resources used by the current instance of the CancellationTokenRegistration class.

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

Syntax

'Declaration
Public Sub Dispose

public void Dispose()

Implements

IDisposable.Dispose()

Exceptions

Exception Condition
ObjectDisposedException

The token source that created this token registration instance has already been disposed.

Remarks

Call Dispose when you are finished using the CancellationTokenRegistration. The Dispose method leaves the CancellationTokenRegistration in an unusable state. After calling Dispose, you must release all references to the CancellationTokenRegistration so the garbage collector can reclaim the memory that the CancellationTokenRegistration was occupying.

For more information, see Cleaning Up Unmanaged Resources and Implementing a Dispose Method.

NoteNote:

Always call Dispose before you release your last reference to the CancellationTokenRegistration. Otherwise, the resources it is using will not be freed until the garbage collector calls the CancellationTokenRegistration object's Finalize method.

Version Information

Silverlight

Supported in: 5

Platforms

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