Timer.Dispose Method (WaitHandle)


The .NET API Reference documentation has a new home. Visit the .NET API Browser on docs.microsoft.com to see the new experience.

Releases all resources used by the current instance of Timer and signals when the timer has been disposed of.

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

public bool Dispose(
	WaitHandle notifyObject


Type: System.Threading.WaitHandle

The WaitHandle to be signaled when the Timer has been disposed of.

Return Value

Type: System.Boolean

true if the function succeeds; otherwise, false.

Exception Condition

The notifyObject parameter is null.

Calling Dispose allows the resources used by the Timer to be reallocated for other purposes. For more information about Dispose, see Cleaning Up Unmanaged Resources.

When this method completes, it signals the WaitHandle specified by the notifyObject parameter.Use this overload of the Dispose method if you want to be able to block until you are certain that the timer has been disposed. The timer is not disposed until all currently queued callbacks have completed.


If the callback uses the Change method to set the dueTime parameter to zero, a race condition can occur when the Dispose(WaitHandle) method overload is called: If the timer queues a new callback before the Dispose(WaitHandle) method overload detects that there are no callbacks queued, Dispose(WaitHandle) continues to block; otherwise, the timer is disposed while the new callback is being queued, and an ObjectDisposedException is thrown when the new callback calls the Change method.

.NET Framework
Available since 1.1
Available since 2.0
Windows Phone Silverlight
Available since 7.0
Return to top