ReaderWriterLockSlim.EnterUpgradeableReadLock 方法

定義

命名空間:

System.Threading

組件:

System.Threading.dll

嘗試進入可升級模式的鎖定狀態。

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 方法的線程會封鎖，直到這些線程逾時或進入寫入模式，然後結束它為止。

注意

如果鎖定允許遞歸，在可升級模式中進入鎖定的線程可以遞歸進入可升級模式，即使其他線程正在等候進入寫入模式也一樣。