ReaderWriterLockSlim.EnterUpgradeableReadLock 메서드

정의

네임스페이스:

System.Threading

어셈블리:

System.Threading.dll

Source:

ReaderWriterLockSlim.cs

업그레이드 가능 모드로 잠금을 시작하려고 합니다.

public:
 void EnterUpgradeableReadLock();

public void EnterUpgradeableReadLock ();

member this.EnterUpgradeableReadLock : unit -> unit

Public Sub EnterUpgradeableReadLock ()

예외

LockRecursionException

RecursionPolicy 속성이 NoRecursion이고 현재 스레드에서 이미 모드에 관계없이 잠금을 시작한 경우

또는

현재 스레드에서 읽기 모드를 시작했으므로 업그레이드 가능 모드를 시작하려고 하면 교착 상태가 발생할 수 있는 경우

또는

재귀 횟수가 카운터의 용량을 초과할 수 있습니다. 이 제한은 매우 크므로 일반적으로 애플리케이션에서 초과되지 않아야 합니다.

ObjectDisposedException

ReaderWriterLockSlim 개체가 삭제되었습니다.

예제

다음 예제에서는 메서드를 사용하여 EnterUpgradeableReadLock 업그레이드 가능한 모드로 잠금을 입력하는 방법을 보여 있습니다. finally 블록은 호출자가 업그레이드 가능한 모드를 ExitUpgradeableReadLock 종료하도록 메서드를 실행하는 데 사용됩니다.

예제에 표시된 메서드는 키와 연결된 값을 검색하고 새 값과 비교합니다. 값이 변경되지 않으면 메서드는 변경되지 않음을 나타내는 상태 반환합니다. 키에 대한 값을 찾을 수 없는 경우 키/값 쌍이 삽입됩니다. 값이 변경되면 업데이트됩니다. 업그레이드 가능한 모드를 사용하면 스레드가 교착 상태의 위험 없이 필요에 따라 읽기 잠금을 업그레이드할 수 있습니다.

이 예제에서는 매개 변수가 없는 생성자를 사용하여 잠금을 만들므로 재귀가 허용되지 않습니다. 잠금에서 ReaderWriterLockSlim 재귀를 허용하지 않는 경우 프로그래밍이 더 간단하고 오류가 발생하기 쉽습니다.

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

private ReaderWriterLockSlim cacheLock = new ReaderWriterLockSlim();
private Dictionary<int, string> innerCache = new Dictionary<int, string>();

Private cacheLock As New ReaderWriterLockSlim()
Private innerCache As New Dictionary(Of Integer, String)

public AddOrUpdateStatus AddOrUpdate(int key, string value)
{
    cacheLock.EnterUpgradeableReadLock();
    try
    {
        string result = null;
        if (innerCache.TryGetValue(key, out result))
        {
            if (result == value)
            {
                return AddOrUpdateStatus.Unchanged;
            }
            else
            {
                cacheLock.EnterWriteLock();
                try
                {
                    innerCache[key] = value;
                }
                finally
                {
                    cacheLock.ExitWriteLock();
                }
                return AddOrUpdateStatus.Updated;
            }
        }
        else
        {
            cacheLock.EnterWriteLock();
            try
            {
                innerCache.Add(key, value);
            }
            finally
            {
                cacheLock.ExitWriteLock();
            }
            return AddOrUpdateStatus.Added;
        }
    }
    finally
    {
        cacheLock.ExitUpgradeableReadLock();
    }
}

Public Function AddOrUpdate(ByVal key As Integer, _
                            ByVal value As String) As AddOrUpdateStatus
    cacheLock.EnterUpgradeableReadLock()
    Try
        Dim result As String = Nothing
        If innerCache.TryGetValue(key, result) Then
            If result = value Then
                Return AddOrUpdateStatus.Unchanged
            Else
                cacheLock.EnterWriteLock()
                Try
                    innerCache.Item(key) = value
                Finally
                    cacheLock.ExitWriteLock()
                End Try
                Return AddOrUpdateStatus.Updated
            End If
        Else
            cacheLock.EnterWriteLock()
            Try
                innerCache.Add(key, value)
            Finally
                cacheLock.ExitWriteLock()
            End Try
            Return AddOrUpdateStatus.Added
        End If
    Finally
        cacheLock.ExitUpgradeableReadLock()
    End Try
End Function

public enum AddOrUpdateStatus
{
    Added,
    Updated,
    Unchanged
};

Public Enum AddOrUpdateStatus
    Added
    Updated
    Unchanged
End Enum

설명

이 메서드는 호출 스레드가 잠금에 들어갈 때까지 차단되므로 반환되지 않을 수 있습니다. 메서드를 TryEnterUpgradeableReadLock 사용하여 지정된 간격 동안 차단한 다음 호출 스레드가 해당 간격 동안 업그레이드 가능 모드로 전환되지 않은 경우 를 반환합니다.

스레드가 일반적으로 읽기 모드에서 로 보호되는 리소스에 ReaderWriterLockSlim 액세스하지만 특정 조건이 충족되는 경우 쓰기 모드로 전환해야 할 수 있는 경우 업그레이드 가능한 모드를 사용합니다. 업그레이드 가능한 모드의 스레드는 읽기 모드로 다운그레이드하거나 쓰기 모드로 업그레이드할 수 있습니다.

한 스레드만 지정된 시간에 업그레이드 가능한 모드로 전환할 수 있습니다. 스레드가 업그레이드 가능한 모드에 있고 쓰기 모드로 전환하기 위해 대기 중인 스레드가 없는 경우 업그레이드 가능한 모드로 전환하기 위해 대기 중인 스레드가 있더라도 다른 스레드 수가 읽기 모드로 전환할 수 있습니다.

하나 이상의 스레드가 쓰기 모드로 전환되기를 기다리는 경우 해당 스레드가 시간 초과되거나 쓰기 모드로 전환된 후 종료될 때까지 메서드를 호출 EnterUpgradeableReadLock 하는 스레드가 차단됩니다.

참고

잠금이 재귀를 허용하는 경우 다른 스레드가 쓰기 모드로 전환되기를 기다리는 경우에도 업그레이드 가능 모드에서 잠금에 진입한 스레드는 업그레이드 가능한 모드로 재귀적으로 들어갈 수 있습니다.