ReaderWriterLockSlim.ExitUpgradeableReadLock 方法

定義

減少可升級模式的遞迴次數,若結果為零(0),則退出可升級模式。

public:
 void ExitUpgradeableReadLock();
public void ExitUpgradeableReadLock();
member this.ExitUpgradeableReadLock : unit -> unit
Public Sub ExitUpgradeableReadLock ()

例外狀況

目前執行緒尚未進入可升級模式的鎖。

範例

以下範例說明如何使用 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

備註

此方法對遞迴順序不敏感。 例如,如果執行緒在可升級模式下進入鎖,然後再以寫入模式進入鎖,執行緒退出這兩種模式的順序並不重要。 若鎖允許遞迴,執行緒可在寫入模式進入鎖,然後以可升級模式以遞迴方式進入;執行緒退出可升級模式與寫入模式的順序並不重要。

退出鎖可能會表示其他線程正在等待。

適用於