Enter Method
Collapse the table of content
Expand the table of content

SpinLock.Enter Method

[ This article is for Windows Phone 8 developers. If you’re developing for Windows 10, see the latest documentation. ]

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.

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

public void Enter(
	ref bool lockTaken
)

Parameters

lockTaken
Type: System.Boolean %
True if the lock is acquired; otherwise, false. lockTaken must be initialized to false prior to calling this method.

ExceptionCondition
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.

Windows Phone OS

Supported in: 8.1, 8.0

Show:
© 2017 Microsoft