Timer::Dispose Method (WaitHandle^)
Releases all resources used by the current instance of Timer and signals when the timer has been disposed of.
Assembly: mscorlib (in mscorlib.dll)
Parameters
- notifyObject
-
Type:
System.Threading::WaitHandle^
The WaitHandle to be signaled when the Timer has been disposed of.
| Exception | Condition |
|---|---|
| ArgumentNullException | 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.
Note |
|---|
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. |
Available since 1.1
Silverlight
Available since 2.0
Windows Phone Silverlight
Available since 7.0
