System.Threading.ReaderWriterLockSlim.TryEnterReadLock Method

Tries to enter the lock in read mode, with an optional time-out.

Syntax

public bool TryEnterReadLock (TimeSpan timeout)

Parameters

timeout
The interval to wait, or -1 milliseconds to wait indefinitely.

Returns

true if the calling thread entered read mode, otherwise, false.

Remarks

If timeout is 0 (zero), this method checks the lock state and returns false immediately if the desired state is unavailable.

Multiple threads can enter the lock in read mode at the same time.

If one or more threads are queued to enter write mode, a thread that calls the ReaderWriterLockSlim.TryEnterReadLock(TimeSpan) method blocks until those threads have either timed out or entered write mode and then exited from it, or until the calling thread's own time-out interval expires.

Note:

If a lock allows recursion, a thread that has entered the lock in read mode can enter read mode recursively, even if other threads are waiting to enter write mode.

One thread can be in upgradeable mode while other threads are in read mode. If additional threads are waiting to enter upgradeable mode, and there are no threads waiting to enter write mode, threads that call the ReaderWriterLockSlim.TryEnterReadLock(TimeSpan) method enter read mode immediately and do not block.

Requirements

Namespace: System.Threading
Assembly: System.Core (in System.Core.dll)
Assembly Versions: 4.0.0.0