LockCookie 구조체

정의

네임스페이스:

System.Threading

어셈블리:

netstandard.dll, System.Threading.dll

Source:

LockCookie.cs

단일 작성기/다중 판독기 의미 체계를 구현하는 잠금을 정의합니다. 값 형식입니다.

public value class LockCookie : IEquatable<System::Threading::LockCookie>

public struct LockCookie : IEquatable<System.Threading.LockCookie>

type LockCookie = struct

Public Structure LockCookie
Implements IEquatable(Of LockCookie)

상속

Object

ValueType

LockCookie

구현

IEquatable<LockCookie>

예제

다음 예제에서는 판독기 잠금을 요청하고, 판독기 잠금을 기록기 잠금으로 업그레이드하고, 저장하는 LockCookie방법을 보여줍니다. 그런 다음 판독 LockCookie 기 잠금으로 다시 다운그레이드하는 데 사용합니다.

이 코드는 클래스에 제공된 더 큰 예제의 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

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

메서드

Name	Description
Equals(LockCookie)	현재 인스턴스가 지정된 LockCookie인스턴스와 같은지 여부를 나타냅니다.
Equals(Object)	지정된 개체 LockCookie 가 현재 인스턴스와 같은지 여부를 나타냅니다.
GetHashCode()	이 인스턴스의 해시 코드를 반환합니다.

연산자

Name	Description
Equality(LockCookie, LockCookie)	두 LockCookie 구조체가 같은지 여부를 나타냅니다.
Inequality(LockCookie, LockCookie)	두 LockCookie 구조체가 같지 않은지 여부를 나타냅니다.

스레드 보안

이 형식은 스레드로부터 안전합니다.

추가 정보

• ReaderWriterLock
• 관리되는 스레딩
• Reader-Writer 잠금