Timer.Dispose Method (WaitHandle)
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)
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. |
Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)
The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.
