SpinLock.Enter Method (Boolean)
![]() |
---|
The .NET API Reference documentation has a new home. Visit the .NET API Browser on docs.microsoft.com to see the new experience. |
Acquires the lock in a reliable manner, such that even if an exception occurs within the method call, lockTaken can be examined reliably to determine whether the lock was acquired.
Assembly: mscorlib (in mscorlib.dll)
Parameters
- lockTaken
-
Type:
System.Boolean
True if the lock is acquired; otherwise, false. lockTaken must be initialized to false prior to calling this method.
Exception | Condition |
---|---|
ArgumentException | The lockTaken argument must be initialized to false prior to calling Enter. |
LockRecursionException | Thread ownership tracking is enabled, and the current thread has already acquired this lock. |
SpinLock is a non-reentrant lock, meaning that if a thread holds the lock, it is not allowed to enter the lock again. If thread ownership tracking is enabled (whether it's enabled is available through IsThreadOwnerTrackingEnabled), an exception will be thrown when a thread tries to re-enter a lock it already holds. However, if thread ownership tracking is disabled, attempting to enter a lock already held will result in deadlock.
If you call Exit without having first called Enter the internal state of the SpinLock can become corrupted.
Available since 8
.NET Framework
Available since 4.0
Portable Class Library
Supported in: portable .NET platforms
Windows Phone Silverlight
Available since 8.0
Windows Phone
Available since 8.1