ReaderWriterLock.AcquireWriterLock 方法

定义

命名空间:

System.Threading

程序集:

netstandard.dll, System.Threading.dll

获取编写器锁。

重载

名称	说明
AcquireWriterLock(Int32)	使用超时值获取编写器锁 Int32 。
AcquireWriterLock(TimeSpan)	使用超时值获取编写器锁 TimeSpan 。

AcquireWriterLock(Int32)

Source:

ReaderWriterLock.cs

使用超时值获取编写器锁 Int32 。

public:
 void AcquireWriterLock(int millisecondsTimeout);

public void AcquireWriterLock(int millisecondsTimeout);

member this.AcquireWriterLock : int -> unit

Public Sub AcquireWriterLock (millisecondsTimeout As Integer)

参数

millisecondsTimeout

Int32

超时（以毫秒为单位）。

例外

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 the writer lock, and handle time-outs.
static void WriteToResource(Random rnd, int timeOut)
{
   try {
      rwl.AcquireWriterLock(timeOut);
      try {
         // It's safe for this thread to access from the shared resource.
         resource = rnd.Next(500);
         Display("writes resource value " + resource);
         Interlocked.Increment(ref writes);
      }
      finally {
         // Ensure that the lock is released.
         rwl.ReleaseWriterLock();
      }
   }
   catch (ApplicationException) {
      // The writer lock request timed out.
      Interlocked.Increment(ref writerTimeouts);
   }
}

' Request and release the writer lock, and handle time-outs.
Sub WriteToResource(rnd As Random, timeOut As Integer)
   Try
      rwl.AcquireWriterLock(timeOut)
      Try
         ' It's safe for this thread to read or write from the shared resource.
         resource = rnd.Next(500)
         Display("writes resource value " & resource)
         Interlocked.Increment(writes)
      Finally
         ' Ensure that the lock is released.
         rwl.ReleaseWriterLock()
      End Try
   Catch ex As ApplicationException
      ' The writer lock request timed out.
      Interlocked.Increment(writerTimeouts)
   End Try
End Sub

}

End Module

注解

如果另一个线程具有读取器锁或写入器锁，则此方法会阻止。 有关编写器锁与多个并发读取器锁交替的方式的说明，请参阅该 ReaderWriterLock 类。

具有读取器锁的线程可以通过以下两种方式之一获取编写器锁：在调用 AcquireWriterLock之前释放读取器锁，或通过调用 UpgradeToWriterLock。

注意

如果线程在仍具有读取器锁时调用 AcquireWriterLock ，它将在其自己的读取器锁上阻止;如果指定无限超时，则线程将死锁。 若要避免此类死锁，请使用 IsReaderLockHeld 它来确定当前线程是否已具有读取器锁。

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

递归锁请求始终会立即授予，而不会将请求线程置于编写器队列中。

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

另请参阅

• 托管线程
• ReaderWriterLock

AcquireWriterLock(TimeSpan)

Source:

ReaderWriterLock.cs

使用超时值获取编写器锁 TimeSpan 。

public:
 void AcquireWriterLock(TimeSpan timeout);

public void AcquireWriterLock(TimeSpan timeout);

member this.AcquireWriterLock : TimeSpan -> unit

Public Sub AcquireWriterLock (timeout As TimeSpan)

参数

timeout

TimeSpan

TimeSpan指定超时期限。

例外

ApplicationException

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

ArgumentOutOfRangeException

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

注解

如果另一个线程具有读取器锁或写入器锁，则此方法会阻止。 有关编写器锁与多个并发读取器锁交替的方式的说明，请参阅该 ReaderWriterLock 类。

具有读取器锁的线程可以通过以下两种方式之一获取编写器锁：在调用 AcquireWriterLock之前释放读取器锁，或通过调用 UpgradeToWriterLock。

注意

如果线程在仍具有读取器锁时调用 AcquireWriterLock ，它将在其自己的读取器锁上阻止;如果指定无限超时，则线程将死锁。 若要避免此类死锁，请使用 IsReaderLockHeld 它来确定当前线程是否已具有读取器锁。

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

递归锁请求始终会立即授予，而不会将请求线程置于编写器队列中。

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

另请参阅

• 托管线程
• ReaderWriterLock