ReaderWriterLockSlim.EnterUpgradeableReadLock Metoda

Definice

Obor názvů:

System.Threading

Sestavení:

netstandard.dll, System.Threading.dll

Zdroj:

ReaderWriterLockSlim.cs

Pokusí se vstoupit do zámku v režimu upgradu.

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 zámek v libovolném režimu.

nebo

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

nebo

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

ObjectDisposedException

Objekt ReaderWriterLockSlim byl odstraněn.

Příklady

Následující příklad ukazuje, jak pomocí EnterUpgradeableReadLock metody zadat zámek v režimu upgradu. Blok finally se používá ke spuštění ExitUpgradeableReadLock metody a zajišťuje, že volající ukončí režim upgradu.

Metoda zobrazená v příkladu načte hodnotu přidruženou ke klíči a porovná ji s novou hodnotou. Pokud je hodnota beze změny, vrátí metoda stav označující žádnou změnu. Pokud se pro klíč nenajde žádná hodnota, vloží se dvojice klíč/hodnota. Pokud se hodnota změnila, aktualizuje se. Upgradovatelný režim umožňuje vláknu podle potřeby upgradovat zámek čtení bez rizika zablokování.

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

Tento kód je součástí většího příkladu poskytovaného 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 nikdy nevrátí. Použijte metodu TryEnterUpgradeableReadLock k blokování pro zadaný interval a poté se vraťte, pokud volající vlákno během tohoto intervalu nezašel do režimu upgradu.

Režim upgradu použijte, když vlákno obvykle přistupuje k prostředku chráněnému ReaderWriterLockSlim v 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 na režim čtení nebo upgradovat na režim zápisu.

V daném okamžiku může do režimu upgradu vstoupit pouze jedno vlákno. Pokud je vlákno v režimu upgradu a neexistují žádná vlákna čekající na vstup do režimu zápisu, může jakýkoli počet dalších vláken vstoupit do režimu čtení, i když existují vlákna čekající na přechod do režimu upgradu.

Pokud jedno nebo více vláken čeká na vstup do režimu zápisu, vlákno, které volá EnterUpgradeableReadLock bloky metody, dokud tyto vlákna buď vypršel časový limit, nebo vstoupil do režimu zápisu a poté se z něj ukončí.

Note

Pokud zámek umožňuje rekurzi, vlákno, které vstoupilo do zámku v upgradovatelném režimu, může rekurzivně vstoupit do režimu upgradu, i když ostatní vlákna čekají na vstup do režimu zápisu.