ReaderWriterLock.AcquireReaderLock 方法

定义

命名空间:
System.Threading
程序集:
netstandard.dll, System.Threading.dll
程序集:
System.Threading.dll
程序集:
mscorlib.dll
程序集:
netstandard.dll

获取读取器锁。

重载

名称 说明
AcquireReaderLock(Int32)

使用 Int32 超时值获取读取器锁。
AcquireReaderLock(TimeSpan)

使用 TimeSpan 超时值获取读取器锁。

AcquireReaderLock(Int32)

Source:
ReaderWriterLock.cs
Source:
ReaderWriterLock.cs
Source:
ReaderWriterLock.cs
Source:
ReaderWriterLock.cs
Source:
ReaderWriterLock.cs

使用 Int32 超时值获取读取器锁。

public:
 void AcquireReaderLock(int millisecondsTimeout);
[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public void AcquireReaderLock(int millisecondsTimeout);
public void AcquireReaderLock(int millisecondsTimeout);
[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
member this.AcquireReaderLock : int -> unit
member this.AcquireReaderLock : int -> unit
Public Sub AcquireReaderLock (millisecondsTimeout As Integer)

参数

millisecondsTimeout
Int32

超时（以毫秒为单位）。

属性
UnsupportedOSPlatformAttribute

例外

ApplicationException

millisecondsTimeout 在授予锁定请求之前过期。

示例

下面的代码示例演示如何获取和释放读取器锁，以及如何处理请求超时时引发的异常。

此代码是为类提供的大型示例的 ReaderWriterLock 一部分。

// The complete code is located in the ReaderWriterLock class topic.
using System;
using System.Threading;

public class Example
{
   static ReaderWriterLock rwl = new ReaderWriterLock();
   // Define the shared resource protected by the ReaderWriterLock.
   static int resource = 0;

' The complete code is located in the ReaderWriterLock class topic.
Imports System.Threading

Public Module Example
   Private rwl As New ReaderWriterLock()
   ' Define the shared resource protected by the ReaderWriterLock.
   Private resource As Integer = 0

// Request and release a reader lock, and handle time-outs.
static void ReadFromResource(int timeOut)
{
   try {
      rwl.AcquireReaderLock(timeOut);
      try {
         // It is safe for this thread to read from the shared resource.
         Display("reads resource value " + resource);
         Interlocked.Increment(ref reads);
      }
      finally {
         // Ensure that the lock is released.
         rwl.ReleaseReaderLock();
      }
   }
   catch (ApplicationException) {
      // The reader lock request timed out.
      Interlocked.Increment(ref readerTimeouts);
   }
}

' Request and release a reader lock, and handle time-outs.
Sub ReadFromResource(timeOut As Integer)
   Try
      rwl.AcquireReaderLock(timeOut)
      Try
         ' It's safe for this thread to read from the shared resource.
         Display("reads resource value " & resource)
         Interlocked.Increment(reads)
      Finally
         ' Ensure that the lock is released.
         rwl.ReleaseReaderLock()
      End Try
   Catch ex As ApplicationException
      ' The reader lock request timed out.
      Interlocked.Increment(readerTimeouts)
   End Try
End Sub

}

End Module

注解

AcquireReaderLock 如果其他线程具有写入器锁，或者至少有一个线程正在等待写入器锁，则阻止。

Note

如果当前线程已有写入器锁，则不会获取读取器锁。 相反，写入器锁上的锁计数会递增。 这可以防止线程在其自己的编写器锁上阻塞。 结果与调用 AcquireWriterLock完全相同，在释放编写器锁时需要对它 ReleaseWriterLock 进行额外的调用。

AcquireReaderLock 支持递归读取器锁请求。 也就是说，线程可以多次调用 AcquireReaderLock，每次都会递增锁计数。 每次呼叫时，都必须调用ReleaseReaderLockAcquireReaderLock一次。 或者，可以调用 ReleaseLock 以立即将锁计数减少到零。

始终立即授予递归锁请求，而不会将请求线程置于读取器队列中。 请谨慎使用递归锁，以避免长时间阻止编写器锁请求。

有关有效的超时值，请参阅 ReaderWriterLock。

另请参阅

适用于

AcquireReaderLock(TimeSpan)

Source:
ReaderWriterLock.cs
Source:
ReaderWriterLock.cs
Source:
ReaderWriterLock.cs
Source:
ReaderWriterLock.cs
Source:
ReaderWriterLock.cs

使用 TimeSpan 超时值获取读取器锁。

public:
 void AcquireReaderLock(TimeSpan timeout);
[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public void AcquireReaderLock(TimeSpan timeout);
public void AcquireReaderLock(TimeSpan timeout);
[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
member this.AcquireReaderLock : TimeSpan -> unit
member this.AcquireReaderLock : TimeSpan -> unit
Public Sub AcquireReaderLock (timeout As TimeSpan)

参数

timeout
TimeSpan

指定 TimeSpan 超时期限。

属性
UnsupportedOSPlatformAttribute

例外

ApplicationException

timeout 在授予锁定请求之前过期。

ArgumentOutOfRangeException

timeout 指定除 -1 毫秒以外的负值。

注解

AcquireReaderLock 如果其他线程具有写入器锁，或者至少有一个线程正在等待写入器锁，则阻止。

Note

如果当前线程已有写入器锁，则不会获取读取器锁。 相反，写入器锁上的锁计数会递增。 这可以防止线程在其自己的编写器锁上阻塞。 结果与调用 AcquireWriterLock完全相同，在释放编写器锁时需要对它 ReleaseWriterLock 进行额外的调用。

AcquireReaderLock 支持递归读取器锁请求。 也就是说，线程可以多次调用 AcquireReaderLock，每次都会递增锁计数。 每次呼叫时，都必须调用ReleaseReaderLockAcquireReaderLock一次。 或者，可以调用 ReleaseLock 以立即将锁计数减少到零。

始终立即授予递归锁请求，而不会将请求线程置于读取器队列中。 请谨慎使用递归锁，以避免长时间阻止编写器锁请求。

有关有效的超时值，请参阅 ReaderWriterLock。

另请参阅

适用于