ReaderWriterLock.AcquireWriterLock 메서드

정의

네임스페이스:

System.Threading

어셈블리:

netstandard.dll, System.Threading.dll

기록기 잠금을 획득합니다.

오버로드

Name	Description
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 는 잠금 요청이 부여되기 전에 만료됩니다.

예제

다음 코드 예제에서는 기록기 잠금을 획득 및 해제하는 방법과 요청 시간이 초과될 때 throw된 예외를 처리하는 방법을 보여 줍니다.

이 코드는 클래스에 제공된 더 큰 예제의 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 참조하세요.

판독기 잠금이 이미 있는 스레드는 호출하기 전에 판독기 잠금을 해제하거나 호출AcquireWriterLockUpgradeToWriterLock하는 두 가지 방법 중 하나로 기록기 잠금을 획득할 수 있습니다.

주의

스레드가 판독기 잠금이 있는 동안 호출 AcquireWriterLock 하는 경우 자체 판독기 잠금에서 차단됩니다. 무한 제한 시간이 지정되면 스레드가 교착 상태가 됩니다. 이러한 교착 상태를 방지하려면 현재 스레드에 이미 판독기 잠금이 있는지 여부를 확인하는 데 사용합니다 IsReaderLockHeld .

AcquireWriterLock 는 재귀 기록기 잠금 요청을 지원합니다. 즉, 스레드는 여러 번 호출 AcquireWriterLock 할 수 있으므로 매번 잠금 수가 증가합니다. 호출할 때마다 한 번 호출 ReleaseWriterLockAcquireWriterLock해야 합니다. 또는 잠금 수를 즉시 0으로 줄이기 위해 호출 ReleaseLock 할 수 있습니다.

재귀 잠금 요청은 요청 스레드를 기록기 큐에 배치하지 않고 항상 즉시 부여됩니다.

유효한 제한 시간 값은 다음을 참조하세요 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 참조하세요.

판독기 잠금이 이미 있는 스레드는 호출하기 전에 판독기 잠금을 해제하거나 호출AcquireWriterLockUpgradeToWriterLock하는 두 가지 방법 중 하나로 기록기 잠금을 획득할 수 있습니다.

주의

스레드가 판독기 잠금이 있는 동안 호출 AcquireWriterLock 하는 경우 자체 판독기 잠금에서 차단됩니다. 무한 제한 시간이 지정되면 스레드가 교착 상태가 됩니다. 이러한 교착 상태를 방지하려면 현재 스레드에 이미 판독기 잠금이 있는지 여부를 확인하는 데 사용합니다 IsReaderLockHeld .

AcquireWriterLock 는 재귀 기록기 잠금 요청을 지원합니다. 즉, 스레드는 여러 번 호출 AcquireWriterLock 할 수 있으므로 매번 잠금 수가 증가합니다. 호출할 때마다 한 번 호출 ReleaseWriterLockAcquireWriterLock해야 합니다. 또는 잠금 수를 즉시 0으로 줄이기 위해 호출 ReleaseLock 할 수 있습니다.

재귀 잠금 요청은 요청 스레드를 기록기 큐에 배치하지 않고 항상 즉시 부여됩니다.

유효한 제한 시간 값은 다음을 참조하세요 ReaderWriterLock.

추가 정보

• 관리되는 스레딩