ReaderWriterLockSlim.EnterUpgradeableReadLock Metoda

Definice

Obor názvů:

System.Threading

Sestavení:

System.Threading.dll

Zdroj:

ReaderWriterLockSlim.cs

Pokusí se přejít na zámek v upgradovatelném režimu.

public:
 void EnterUpgradeableReadLock();

public void EnterUpgradeableReadLock ();

member this.EnterUpgradeableReadLock : unit -> unit

Public Sub EnterUpgradeableReadLock ()

Výjimky

LockRecursionException

Vlastnost RecursionPolicy je NoRecursion a aktuální vlákno již vstoupilo do zámku v libovolném režimu.

-nebo-

Aktuální vlákno přešlo do režimu čtení, takže pokus o přechod do upgradovatelného režimu by vytvořil možnost vzájemného zablokování.

-nebo-

Číslo rekurze by překročilo kapacitu čítače. Limit je tak velký, že by se s ním aplikace nikdy neměly setkat.

ObjectDisposedException

Objekt ReaderWriterLockSlim byl odstraněn.

Příklady

Následující příklad ukazuje, jak použít metodu EnterUpgradeableReadLock k zadání zámku v upgradovatelném režimu. Ke finally spuštění ExitUpgradeableReadLock metody se používá blok, který zajišťuje, že volající ukončí upgradovatelný režim.

Metoda uvedená v příkladu načte hodnotu přidruženou ke klíči a porovná ji s novou hodnotou. Pokud se hodnota nezmění, vrátí metoda stav označující, že nedošlo k žádné změně. Pokud se pro klíč nenajde žádná hodnota, vloží se pár klíč-hodnota. Pokud se hodnota změnila, aktualizuje se. Upgradovatelný režim umožňuje vláknu upgradovat zámek čtení podle potřeby, bez rizika vzájemného zablokování.

V příkladu se k vytvoření zámku používá konstruktor bez parametrů, takže rekurze není povolená. ReaderWriterLockSlim Programování je jednodušší a méně náchylné k chybám, pokud zámek neumožňuje rekurze.

Tento kód je součástí většího příkladu ReaderWriterLockSlim pro třídu .

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

Poznámky

Tato metoda blokuje, dokud volající vlákno nezadá zámek, a proto se nemusí nikdy vrátit. Použijte metodu TryEnterUpgradeableReadLock k blokování po zadaný interval a poté vrátit, pokud volající vlákno nevstoupilo do upgradovatelného režimu během tohoto intervalu.

Režim upgradovatelné použijte, když vlákno obvykle přistupuje k prostředku, který je chráněný v ReaderWriterLockSlim režimu čtení, ale může být nutné přejít do režimu zápisu, pokud jsou splněny určité podmínky. Vlákno v upgradovatelném režimu může downgradovat do režimu čtení nebo upgradovat na režim zápisu.

V daném okamžiku může do upgradovatelného režimu vstoupit pouze jedno vlákno. Pokud je vlákno v upgradovatelném režimu a neexistují žádná vlákna čekající na přechod do režimu zápisu, libovolný počet dalších vláken může přejít do režimu čtení, a to i v případě, že existují vlákna čekající na přechod do upgradovatelného režimu.

Pokud jeden nebo více vláken čekají na vstup do režimu zápisu, vlákno, které volá metodu EnterUpgradeableReadLock bloky, dokud tyto vlákna buď vypršel časový limit, nebo přejít do režimu zápisu, a poté jej ukončit.

Poznámka

Pokud zámek umožňuje rekurze, vlákno, které vstoupilo do zámku v upgradovatelném režimu, může přejít do upgradovatelného režimu rekurzivně, a to i v případě, že jiná vlákna čekají na přechod do režimu zápisu.