ManualResetEventSlim Class
Provides a slimmed down version of ManualResetEvent.
Assembly: mscorlib (in mscorlib.dll)
The ManualResetEventSlim type exposes the following members.
| Name | Description | |
|---|---|---|
![]() | ManualResetEventSlim() | Initializes a new instance of the ManualResetEventSlim class with an initial state of nonsignaled. |
![]() | ManualResetEventSlim(Boolean) | Initializes a new instance of the ManualResetEventSlim class with a Boolean value indicating whether to set the intial state to signaled. |
![]() | ManualResetEventSlim(Boolean, Int32) | Initializes a new instance of the ManualResetEventSlim class with a Boolean value indicating whether to set the intial state to signaled and a specified spin count. |
| Name | Description | |
|---|---|---|
![]() | IsSet | Gets whether the event is set. |
![]() | SpinCount | Gets the number of spin waits that will be occur before falling back to a kernel-based wait operation. |
![]() | WaitHandle | Gets the underlying WaitHandle object for this ManualResetEventSlim. |
| Name | Description | |
|---|---|---|
![]() | Dispose() | Releases all resources used by the current instance of the ManualResetEventSlim class. |
![]() | Dispose(Boolean) | When overridden in a derived class, releases the unmanaged resources used by the ManualResetEventSlim, and optionally releases the managed resources. |
![]() | Equals(Object) | Determines whether the specified Object is equal to the current Object. (Inherited from Object.) |
![]() | Finalize | Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection. (Inherited from Object.) |
![]() | GetHashCode | Serves as a hash function for a particular type. (Inherited from Object.) |
![]() | GetType | Gets the Type of the current instance. (Inherited from Object.) |
![]() | MemberwiseClone | Creates a shallow copy of the current Object. (Inherited from Object.) |
![]() | Reset | Sets the state of the event to nonsignaled, which causes threads to block. |
![]() | Set | Sets the state of the event to signaled, which allows one or more threads waiting on the event to proceed. |
![]() | ToString | Returns a string that represents the current object. (Inherited from Object.) |
![]() | Wait() | Blocks the current thread until the current ManualResetEventSlim is set. |
![]() | Wait(CancellationToken) | Blocks the current thread until the current ManualResetEventSlim receives a signal, while observing a CancellationToken. |
![]() | Wait(Int32) | Blocks the current thread until the current ManualResetEventSlim is set, using a 32-bit signed integer to measure the time interval. |
![]() | Wait(TimeSpan) | Blocks the current thread until the current ManualResetEventSlim is set, using a TimeSpan to measure the time interval. |
![]() | Wait(Int32, CancellationToken) | Blocks the current thread until the current ManualResetEventSlim is set, using a 32-bit signed integer to measure the time interval, while observing a CancellationToken. |
![]() | Wait(TimeSpan, CancellationToken) | Blocks the current thread until the current ManualResetEventSlim is set, using a TimeSpan to measure the time interval, while observing a CancellationToken. |
Note |
|---|
The HostProtectionAttribute attribute applied to this type or member has the following Resources property value: Synchronization | ExternalThreading. The HostProtectionAttribute does not affect desktop applications (which are typically started by double-clicking an icon, typing a command, or entering a URL in a browser). For more information, see the HostProtectionAttribute class or SQL Server Programming and Host Protection Attributes. |
The following example shows how to use a ManualResetEventSlim. For more information about the use of SpinCount and other best practices concerning the use of this type, see ManualResetEvent and ManualResetEventSlim.
using System; using System.Threading; using System.Threading.Tasks; class MRESDemo { static void Main() { MRES_SetWaitReset(); MRES_SpinCountWaitHandle(); } // Demonstrates: // ManualResetEventSlim construction // ManualResetEventSlim.Wait() // ManualResetEventSlim.Set() // ManualResetEventSlim.Reset() // ManualResetEventSlim.IsSet static void MRES_SetWaitReset() { ManualResetEventSlim mres1 = new ManualResetEventSlim(false); // initialize as unsignaled ManualResetEventSlim mres2 = new ManualResetEventSlim(false); // initialize as unsignaled ManualResetEventSlim mres3 = new ManualResetEventSlim(true); // initialize as signaled // Start an asynchronous Task that manipulates mres3 and mres2 var observer = Task.Factory.StartNew(() => { mres1.Wait(); Console.WriteLine("observer sees signaled mres1!"); Console.WriteLine("observer resetting mres3..."); mres3.Reset(); // should switch to unsignaled Console.WriteLine("observer signalling mres2"); mres2.Set(); }); Console.WriteLine("main thread: mres3.IsSet = {0} (should be true)", mres3.IsSet); Console.WriteLine("main thread signalling mres1"); mres1.Set(); // This will "kick off" the observer Task mres2.Wait(); // This won't return until observer Task has finished resetting mres3 Console.WriteLine("main thread sees signaled mres2!"); Console.WriteLine("main thread: mres3.IsSet = {0} (should be false)", mres3.IsSet); // It's good form to Dispose() a ManualResetEventSlim when you're done with it observer.Wait(); // make sure that this has fully completed mres1.Dispose(); mres2.Dispose(); mres3.Dispose(); } // Demonstrates: // ManualResetEventSlim construction w/ SpinCount // ManualResetEventSlim.WaitHandle static void MRES_SpinCountWaitHandle() { // Construct a ManualResetEventSlim with a SpinCount of 1000 // Higher spincount => longer time the MRES will spin-wait before taking lock ManualResetEventSlim mres1 = new ManualResetEventSlim(false, 1000); ManualResetEventSlim mres2 = new ManualResetEventSlim(false, 1000); Task bgTask = Task.Factory.StartNew(() => { // Just wait a little Thread.Sleep(100); // Now signal both MRESes Console.WriteLine("Task signalling both MRESes"); mres1.Set(); mres2.Set(); }); // A common use of MRES.WaitHandle is to use MRES as a participant in // WaitHandle.WaitAll/WaitAny. Note that accessing MRES.WaitHandle will // result in the unconditional inflation of the underlying ManualResetEvent. WaitHandle.WaitAll(new WaitHandle[] { mres1.WaitHandle, mres2.WaitHandle }); Console.WriteLine("WaitHandle.WaitAll(mres1.WaitHandle, mres2.WaitHandle) completed."); // Clean up bgTask.Wait(); mres1.Dispose(); mres2.Dispose(); } }
Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2
The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.
All public and protected members of ManualResetEventSlim are thread-safe and may be used concurrently from multiple threads, with the exception of Dispose, which must only be used when all other operations on the ManualResetEventSlim have completed, and Reset, which should only be used when no other threads are accessing the event.



Note