ReaderWriterLock.UpgradeToWriterLock 메서드

참조

정의

네임스페이스:: System.Threading

어셈블리:: System.Threading.dll

어셈블리:: mscorlib.dll

어셈블리:: netstandard.dll

중요

일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.

판독기 잠금을 작성기 잠금으로 업그레이드합니다.

오버로드

UpgradeToWriterLock(Int32)	제한 시간에 Int32 값을 사용하여 판독기 잠금을 작성기 잠금으로 업그레이드합니다.
UpgradeToWriterLock(TimeSpan)	제한 시간에 `TimeSpan` 값을 사용하여 판독기 잠금을 작성기 잠금으로 업그레이드합니다.

UpgradeToWriterLock(Int32)

제한 시간에 Int32 값을 사용하여 판독기 잠금을 작성기 잠금으로 업그레이드합니다.

public:
 System::Threading::LockCookie UpgradeToWriterLock(int millisecondsTimeout);

public System.Threading.LockCookie UpgradeToWriterLock (int millisecondsTimeout);

[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public System.Threading.LockCookie UpgradeToWriterLock (int millisecondsTimeout);

member this.UpgradeToWriterLock : int -> System.Threading.LockCookie

[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
member this.UpgradeToWriterLock : int -> System.Threading.LockCookie

Public Function UpgradeToWriterLock (millisecondsTimeout As Integer) As LockCookie

매개 변수

millisecondsTimeout: Int32

제한 시간(밀리초)입니다.

반환

LockCookie

LockCookie 값입니다.

특성: UnsupportedOSPlatformAttribute

예외

ApplicationException

잠금 요청이 부여되기 전에 millisecondsTimeout이 만료된 경우

예제

다음 코드 예제에서는 판독기 잠금을 요청하고, 판독기 잠금을 기록기 잠금으로 업그레이드하고, 판독기 잠금으로 다시 다운그레이드하는 방법을 보여줍니다.

이 코드는 클래스에 제공된 더 큰 예제의 ReaderWriterLock 일부입니다.

// The complete code is located in the ReaderWriterLock
// class topic.
using namespace System;
using namespace System::Threading;
public ref class Test
{
public:

   // Declaring the ReaderWriterLock at the class level
   // makes it visible to all threads.
   static ReaderWriterLock^ rwl = gcnew ReaderWriterLock;

   // For this example, the shared resource protected by the
   // ReaderWriterLock is just an integer.
   static int resource = 0;

// 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

// Shows how to request a reader lock, upgrade the
// reader lock to the writer lock, and downgrade to a
// reader lock again.
static void UpgradeDowngrade( Random^ rnd, int timeOut )
{
   try
   {
      rwl->AcquireReaderLock( timeOut );
      try
      {

         // It is safe for this thread to read from
         // the shared resource.
         Display( String::Format( "reads resource value {0}", resource ) );
         Interlocked::Increment( reads );

         // If it is necessary to write to the resource,
         // you must either release the reader lock and
         // then request the writer lock, or upgrade the
         // reader lock. Note that upgrading the reader lock
         // puts the thread in the write queue, behind any
         // other threads that might be waiting for the
         // writer lock.
         try
         {
            LockCookie lc = rwl->UpgradeToWriterLock( timeOut );
            try
            {

               // It is safe for this thread to read or write
               // from the shared resource.
               resource = rnd->Next( 500 );
               Display( String::Format( "writes resource value {0}", resource ) );
               Interlocked::Increment( writes );
            }
            finally
            {

               // Ensure that the lock is released.
               rwl->DowngradeFromWriterLock( lc );
            }

         }
         catch ( ApplicationException^ )
         {

            // The upgrade request timed out.
            Interlocked::Increment( writerTimeouts );
         }


         // When the lock has been downgraded, it is
         // still safe to read from the resource.
         Display( String::Format( "reads resource value {0}", resource ) );
         Interlocked::Increment( reads );
      }
      finally
      {

         // Ensure that the lock is released.
         rwl->ReleaseReaderLock();
      }

   }
   catch ( ApplicationException^ )
   {

      // The reader lock request timed out.
      Interlocked::Increment( readerTimeouts );
   }

}

// Requests a reader lock, upgrades the reader lock to the writer
// lock, and downgrades it to a reader lock again.
static void UpgradeDowngrade(Random rnd, int timeOut)
{
   try {
      rwl.AcquireReaderLock(timeOut);
      try {
         // It's safe for this thread to read from the shared resource.
         Display("reads resource value " + resource);
         Interlocked.Increment(ref reads);

         // To write to the resource, either release the reader lock and
         // request the writer lock, or upgrade the reader lock. Upgrading
         // the reader lock puts the thread in the write queue, behind any
         // other threads that might be waiting for the writer lock.
         try {
            LockCookie lc = rwl.UpgradeToWriterLock(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(ref writes);
            }
            finally {
               // Ensure that the lock is released.
               rwl.DowngradeFromWriterLock(ref lc);
            }
         }
         catch (ApplicationException) {
            // The upgrade request timed out.
            Interlocked.Increment(ref writerTimeouts);
         }

         // If the lock was downgraded, it's still safe to read from the 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);
   }
}

' Requests a reader lock, upgrades the reader lock to the writer
' lock, and downgrades it to a reader lock again.
Sub UpgradeDowngrade(rnd As Random, 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)
         
         ' To write to the resource, either release the reader lock and
         ' request the writer lock, or upgrade the reader lock. Upgrading
         ' the reader lock puts the thread in the write queue, behind any
         ' other threads that might be waiting for the writer lock.
         Try
            Dim lc As LockCookie = rwl.UpgradeToWriterLock(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.DowngradeFromWriterLock(lc)
            End Try
         Catch ex As ApplicationException
            ' The upgrade request timed out.
            Interlocked.Increment(writerTimeouts)
         End Try
         
         ' If the lock was downgraded, it's still safe to read from the 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

설명

스레드가 호출 UpgradeToWriterLock 할 때 잠금 수에 관계없이 판독기 잠금이 해제되고 스레드는 기록기 잠금에 대한 큐의 끝으로 이동합니다. 따라서 업그레이드를 요청한 스레드에 기록기 잠금이 부여되기 전에 다른 스레드가 리소스에 쓸 수 있습니다.

중요

메서드를 호출 UpgradeToWriterLock 한 스레드가 판독기 잠금을 다시 가져올 수 있을 때까지 시간 제한 예외가 throw되지 않습니다. 기록기 잠금을 기다리는 다른 스레드가 없으면 즉시 발생합니다. 그러나 다른 스레드가 기록기 잠금을 위해 대기 중인 경우 메서드를 호출 UpgradeToWriterLock 한 스레드는 모든 현재 판독기가 잠금을 해제하고 한 스레드가 기록기 잠금을 획득하고 해제할 때까지 판독기 잠금을 다시 가져올 수 없습니다. 기록기 잠금을 요청한 다른 스레드가 메서드를 호출 UpgradeToWriterLock 한 현재 스레드 이후에 요청한 경우에도 마찬가지입니다.

잠금 상태를 복원하려면 반환된 LockCookie UpgradeToWriterLock값을 사용하여 호출 DowngradeFromWriterLock 합니다. 에서는 RestoreLock이 LockCookie 작업을 사용하지 마세요.

스레드에 판독기 잠금이 없는 경우 .UpgradeToWriterLock 대신 AcquireWriterLock를 사용하세요.

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

추가 정보

적용 대상

UpgradeToWriterLock(TimeSpan)

제한 시간에 TimeSpan 값을 사용하여 판독기 잠금을 작성기 잠금으로 업그레이드합니다.

public:
 System::Threading::LockCookie UpgradeToWriterLock(TimeSpan timeout);

public System.Threading.LockCookie UpgradeToWriterLock (TimeSpan timeout);

[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public System.Threading.LockCookie UpgradeToWriterLock (TimeSpan timeout);

member this.UpgradeToWriterLock : TimeSpan -> System.Threading.LockCookie

[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
member this.UpgradeToWriterLock : TimeSpan -> System.Threading.LockCookie

Public Function UpgradeToWriterLock (timeout As TimeSpan) As LockCookie

매개 변수

timeout: TimeSpan

제한 시간을 지정하는 TimeSpan입니다.

반환

LockCookie

LockCookie 값입니다.

특성: UnsupportedOSPlatformAttribute

예외

ApplicationException

잠금 요청이 부여되기 전에 timeout이 만료된 경우

ArgumentOutOfRangeException

timeout이 -1밀리초 이외의 음수 값을 지정하는 경우

설명

중요

스레드에 판독기 잠금이 없는 경우 .UpgradeToWriterLock 대신 AcquireWriterLock를 사용하세요.

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

추가 정보

적용 대상

다음을 통해 공유

ReaderWriterLock.UpgradeToWriterLock 메서드

정의

오버로드

UpgradeToWriterLock(Int32)

매개 변수

반환

예외

예제

설명

추가 정보

적용 대상

UpgradeToWriterLock(TimeSpan)

매개 변수

반환

예외

설명

추가 정보

적용 대상

추가 리소스