ReaderWriterLockSlim.EnterUpgradeableReadLock Metódus

Definíció

Névtér:

System.Threading

Szerelvény:

System.Core.dll

Frissíthető módban próbál meg belépni a zárolásba.

public:
 void EnterUpgradeableReadLock();

public void EnterUpgradeableReadLock();

member this.EnterUpgradeableReadLock : unit -> unit

Public Sub EnterUpgradeableReadLock ()

Kivételek

LockRecursionException

A RecursionPolicy tulajdonság az, NoRecursion és az aktuális szál már bármilyen módban belépett a zárolásba.

-vagy-

Az aktuális szál belépett az olvasási módba, így a frissíthető módba való belépéssel holtpontot teremthet.

-vagy-

A rekurziós szám meghaladná a számláló kapacitását. A korlát olyan nagy, hogy az alkalmazások soha nem találkozhatnak vele.

ObjectDisposedException

Az ReaderWriterLockSlim objektumot megsemmisítették.

Példák

Az alábbi példa bemutatja, hogyan használhatja a metódust a EnterUpgradeableReadLock zárolás frissíthető módban való megadására. A finally metódus végrehajtásához ExitUpgradeableReadLock blokkot használunk, amely biztosítja, hogy a hívó kilépjen a frissíthető módból.

A példában látható metódus lekéri a kulcshoz társított értéket, és összehasonlítja egy új értékkel. Ha az érték nem változik, a metódus olyan állapotot ad vissza, amely nem változik. Ha nem található érték a kulcshoz, a rendszer beszúrja a kulcsot/értékpárt. Ha az érték megváltozott, az frissül. A frissíthető mód lehetővé teszi, hogy a szál szükség szerint frissítse az olvasási zárat, holtpontok veszélye nélkül.

A példa a paraméter nélküli konstruktort használja a zárolás létrehozásához, ezért a rekurzió nem engedélyezett. A programozás ReaderWriterLockSlim egyszerűbb és kevésbé hajlamos a hibákra, ha a zárolás nem teszi lehetővé a rekurziót.

Ez a kód egy nagyobb, az ReaderWriterLockSlim osztályhoz tartozó példa része.

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

Megjegyzések

Ez a metódus letiltja, amíg a hívó szál be nem lép a zárolásba, ezért előfordulhat, hogy soha nem tér vissza. TryEnterUpgradeableReadLock A metódussal letilthat egy megadott időközt, majd visszatérhet, ha a hívó szál nem lépett be frissíthető módba az adott időköz alatt.

Frissíthető módot akkor használjon, ha egy szál általában hozzáfér az olvasási módban védett ReaderWriterLockSlim erőforráshoz, de bizonyos feltételek teljesülése esetén előfordulhat, hogy írási módba kell lépnie. A frissíthető módban lévő szálak olvasási módra vagy írási módra válthatnak.

Egyszerre csak egy szál léphet be frissíthető módba. Ha egy szál frissíthető módban van, és nincsenek olyan szálak, amelyek írási módba való belépésre várnak, akkor is számos más szál léphet be olvasási módba, még akkor is, ha vannak olyan szálak, amelyek a frissíthető módba való belépésre várnak.

Ha egy vagy több szál írási módra vár, egy olyan szál, amely addig blokkolja a EnterUpgradeableReadLock metódusblokkokat, amíg ezek a szálak időtúllépést vagy írási módot nem adnak meg, majd kilépnek belőle.

Note

Ha a zárolás lehetővé teszi a rekurziót, a zárolást frissíthető módban belépett szálak rekurzív módon léphetnek be, még akkor is, ha más szálak írási módra várnak.