ReaderWriterLock.UpgradeToWriterLock 메서드

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

매개 변수

반환

LockCookie

LockCookie 값입니다.

특성

UnsupportedOSPlatformAttribute

예외

예제

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

이 코드는 클래스에 제공된 더 큰 예제의 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 할 때 잠금 수에 관계없이 판독기 잠금이 해제되고 스레드는 기록기 잠금에 대한 큐의 끝으로 이동합니다. 따라서 업그레이드를 요청한 스레드에 기록기 잠금이 부여되기 전에 다른 스레드가 리소스에 쓸 수 있습니다.

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

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

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

추가 정보

• 관리형 스레딩
• ReaderWriterLock

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

매개 변수

반환

LockCookie

LockCookie 값입니다.

특성

UnsupportedOSPlatformAttribute

예외

설명

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

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

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

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

추가 정보

• 관리형 스레딩
• ReaderWriterLock