LockRecursionException Osztály

Definíció

Névtér:

System.Threading

Szerelvény:

mscorlib.dll

A rekurzív zárolásba való rekurzív belépéskor megjelenő kivétel nem kompatibilis a zárolás rekurziós szabályzatával.

public ref class LockRecursionException : Exception

[System.Serializable]
public class LockRecursionException : Exception

[<System.Serializable>]
type LockRecursionException = class
    inherit Exception

Public Class LockRecursionException
Inherits Exception

Öröklődés

Object

Exception

LockRecursionException

Attribútumok

SerializableAttribute

Példák

Az alábbi példa az osztály használatának ReaderWriterLockSlim két okát LockRecursionException mutatja be. A program létrehoz egy ReaderWriterLockSlim paraméter nélküli konstruktort, amely nem engedélyezi a rekurziót. A program ezután elindít egy szálat, amely olvasási módban lép be a zárolásba. A szál rekurzív módon próbál belépni a zárolásba olvasási módban, és elkapja az ebből eredő kivételt. Végül a szál írási módba próbál lépni, ami holtpontokra is lehetőséget adna. A szál elkapja az eredményként kapott kivételt.

using System;
using System.Threading;

class Example
{
    // By default, the lock recursion policy for a new 
    // ReaderWriterLockSlim does not allow recursion.
    static ReaderWriterLockSlim rwls = new ReaderWriterLockSlim();

    static void ThreadProc()
    {
        Console.WriteLine("Acquire the reader lock.");
        rwls.EnterReadLock();

        try
        {
            Console.WriteLine("\nAttempt to acquire the reader lock recursively:");
            rwls.EnterReadLock();
        }
        catch (LockRecursionException lre)
        {
            Console.WriteLine("{0}: {1}", 
                lre.GetType().Name, lre.Message);
        }

        try
        {
            Console.WriteLine("\nAttempt to acquire the writer lock recursively:");
            rwls.EnterWriteLock();
        }
        catch (LockRecursionException lre)
        {
            Console.WriteLine("{0}: {1}", 
                lre.GetType().Name, lre.Message);
        }
    }

    static void Main()
    {
        Thread t = new Thread(ThreadProc);
        t.Start();
        t.Join();
    }
}

/* This code example produces output similar to the following:

Acquire the reader lock.

Attempt to acquire the reader lock recursively:
LockRecursionException: Recursive read lock acquisitions not allowed in this mode.

Attempt to acquire the writer lock recursively:
LockRecursionException: Write lock may not be acquired with read lock held. This pattern is prone to deadlocks. Consider using the upgrade lock.
 */

Imports System.Threading

Class Example
    ' By default, the lock recursion policy for a new 
    ' ReaderWriterLockSlim does not allow recursion.
    Private Shared rwls As New ReaderWriterLockSlim()
    
    Shared Sub ThreadProc() 
        Console.WriteLine("Acquire the reader lock.")
        rwls.EnterReadLock()
        
        Try
            Console.WriteLine(vbCrLf & _
                "Attempt to acquire the reader lock recursively:")
            rwls.EnterReadLock()
        Catch lre As LockRecursionException
            Console.WriteLine("{0}: {1}", _
                lre.GetType().Name, lre.Message)
        End Try
        
        Try
            Console.WriteLine(vbCrLf & _
                "Attempt to acquire the writer lock recursively:")
            rwls.EnterWriteLock()
        Catch lre As LockRecursionException
            Console.WriteLine("{0}: {1}", _
                lre.GetType().Name, lre.Message)
        End Try
    
    End Sub 
    
    Shared Sub Main() 

        Dim t As New Thread(AddressOf ThreadProc)
        t.Start()
        t.Join()
    
    End Sub 
End Class 

' This code example produces output similar to the following:
'
'Acquire the reader lock.
'
'Attempt to acquire the reader lock recursively:
'LockRecursionException: Recursive read lock acquisitions not allowed in this mode.
'
'Attempt to acquire the writer lock recursively:
'LockRecursionException: Write lock may not be acquired with read lock held. This pattern is prone to deadlocks. Consider using the upgrade lock.
'

Megjegyzések

LockRecursionException több oka is van, többek között a következők miatt:

• Ha egy szál rekurzív módon próbál meg egy példányt ReaderWriterLockSlim megadni, de a példány nem támogatja a rekurziót.

• Ha egy szál írási módban vagy frissíthető módban próbál meg bevinni egy ReaderWriterLockSlim példányt, amikor a szál kezdetben olvasási módban lépett be a zárolásba. Ez potenciális holtpontot jelent, ezért nem engedélyezett.

• Ha egy újabb rekurziós szint engedélyezése meghaladja a rekurziók nyomon követéséhez használt belső tárolószámláló maximális értékét. Ez a korlát olyan nagy, hogy az alkalmazások soha nem találkozhatnak vele.

Konstruktorok

Name	Description
LockRecursionException()	Inicializálja az LockRecursionException osztály új példányát egy rendszer által megadott üzenettel, amely leírja a hibát.
LockRecursionException(SerializationInfo, StreamingContext)	Inicializálja az LockRecursionException osztály új példányát szerializált adatokkal.
LockRecursionException(String, Exception)	Inicializálja az LockRecursionException osztály új példányát egy megadott hibaüzenettel és a kivétel okaként szolgáló belső kivételre mutató hivatkozással.
LockRecursionException(String)	Inicializálja az LockRecursionException osztály új példányát egy megadott üzenettel, amely leírja a hibát.

Tulajdonságok

Name	Description
Data	Lekéri a kulcs-/érték párok gyűjteményét, amelyek további, felhasználó által definiált információkat biztosítanak a kivételről. (Öröklődés forrása Exception)
HelpLink	Lekéri vagy beállítja a kivételhez társított súgófájlra mutató hivatkozást. (Öröklődés forrása Exception)
HResult	Lekéri vagy beállítja a HRESULT-ot, egy kódolt numerikus értéket, amely egy adott kivételhez van hozzárendelve. (Öröklődés forrása Exception)
InnerException	Lekéri az Exception aktuális kivételt okozó példányt. (Öröklődés forrása Exception)
Message	Az aktuális kivételt leíró üzenet jelenik meg. (Öröklődés forrása Exception)
Source	Lekéri vagy beállítja az alkalmazás vagy a hibát okozó objektum nevét. (Öröklődés forrása Exception)
StackTrace	Lekéri a hívásverem közvetlen kereteinek sztringképét. (Öröklődés forrása Exception)
TargetSite	Lekéri az aktuális kivételt okozó metódust. (Öröklődés forrása Exception)

Metódusok

Name	Description
Equals(Object)	Meghatározza, hogy a megadott objektum egyenlő-e az aktuális objektummal. (Öröklődés forrása Object)
GetBaseException()	Ha egy származtatott osztály felül van bírálva, egy Exception vagy több későbbi kivétel kiváltó okát adja vissza. (Öröklődés forrása Exception)
GetHashCode()	Ez az alapértelmezett kivonatoló függvény. (Öröklődés forrása Object)
GetObjectData(SerializationInfo, StreamingContext)	Ha felül van bírálva egy származtatott osztályban, a SerializationInfo kivétel adatait adja meg. (Öröklődés forrása Exception)
GetType()	Lekéri az aktuális példány futtatókörnyezeti típusát. (Öröklődés forrása Exception)
MemberwiseClone()	Az aktuális Objectpéldány sekély másolatát hozza létre. (Öröklődés forrása Object)
ToString()	Létrehozza és visszaadja az aktuális kivétel sztring-ábrázolását. (Öröklődés forrása Exception)

esemény

Name	Description
SerializeObjectState	Akkor fordul elő, ha a kivétel szerializálva van egy kivételállapot-objektum létrehozásához, amely szerializált adatokat tartalmaz a kivételről. (Öröklődés forrása Exception)

Lásd még

• ReaderWriterLockSlim