LockRecursionException Klasse

Definition

Namespace:

System.Threading

Assembly:

mscorlib.dll

Die Ausnahme, die ausgelöst wird, wenn rekursive Eingabe in eine Sperre nicht mit der Rekursionsrichtlinie für die Sperre kompatibel ist.

public ref class LockRecursionException : Exception

[System.Serializable]
public class LockRecursionException : Exception

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

Public Class LockRecursionException
Inherits Exception

Vererbung

Object

Exception

LockRecursionException

Attribute

SerializableAttribute

Beispiele

Das folgende Beispiel zeigt zwei Ursachen für LockRecursionException die Verwendung der ReaderWriterLockSlim Klasse. Das Programm erstellt eine ReaderWriterLockSlim mithilfe des parameterlosen Konstruktors, der rekursion nicht zuweist. Das Programm startet dann einen Thread, der in den Lesemodus wechselt. Der Thread versucht, die Sperre rekursiv im Lesemodus einzugeben und die resultierende Ausnahme abzufangen. Schließlich versucht der Thread, in den Schreibmodus zu wechseln, was ein Potenzial für Deadlocks schaffen würde. Der Thread fängt die resultierende Ausnahme ab.

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.
'

Hinweise

LockRecursionException wird aus mehreren Gründen ausgelöst, einschließlich der folgenden:

• Wenn ein Thread versucht, eine Instanz rekursiv ReaderWriterLockSlim einzugeben, aber die Instanz unterstützt keine Rekursion.

• Wenn ein Thread versucht, eine ReaderWriterLockSlim Instanz im Schreibmodus oder im Upgrademodus einzugeben, wenn der Thread die Sperre anfänglich in den Lesemodus eingegeben hat. Dies stellt einen potenziellen Deadlock dar und ist daher nicht zulässig.

• Wenn eine weitere Rekursionsebene zugelassen wird, würde der Maximalwert für den internen Speicherzähler überschritten, der zum Nachverfolgen von Rekursionen verwendet wird. Dieser Grenzwert ist so groß, dass Anwendungen niemals darauf stoßen sollten.

Konstruktoren

Name	Beschreibung
LockRecursionException()	Initialisiert eine neue Instanz der LockRecursionException Klasse mit einer vom System bereitgestellten Meldung, die den Fehler beschreibt.
LockRecursionException(SerializationInfo, StreamingContext)	Initialisiert eine neue Instanz der LockRecursionException Klasse mit serialisierten Daten.
LockRecursionException(String, Exception)	Initialisiert eine neue Instanz der LockRecursionException Klasse mit einer angegebenen Fehlermeldung und einem Verweis auf die innere Ausnahme, die die Ursache dieser Ausnahme ist.
LockRecursionException(String)	Initialisiert eine neue Instanz der LockRecursionException Klasse mit einer angegebenen Meldung, die den Fehler beschreibt.

Eigenschaften

Name	Beschreibung
Data	Ruft eine Auflistung von Schlüssel-Wert-Paaren ab, die zusätzliche benutzerdefinierte Informationen zur Ausnahme bereitstellen. (Geerbt von Exception)
HelpLink	Dient zum Abrufen oder Festlegen eines Links zur Hilfedatei, die dieser Ausnahme zugeordnet ist. (Geerbt von Exception)
HResult	Dient zum Abrufen oder Festlegen von HRESULT, einem codierten numerischen Wert, der einer bestimmten Ausnahme zugewiesen ist. (Geerbt von Exception)
InnerException	Ruft die Exception Instanz ab, die die aktuelle Ausnahme verursacht hat. (Geerbt von Exception)
Message	Ruft eine Nachricht ab, die die aktuelle Ausnahme beschreibt. (Geerbt von Exception)
Source	Dient zum Abrufen oder Festlegen des Namens der Anwendung oder des Objekts, das den Fehler verursacht. (Geerbt von Exception)
StackTrace	Ruft eine Zeichenfolgendarstellung der unmittelbaren Frames im Aufrufstapel ab. (Geerbt von Exception)
TargetSite	Ruft die Methode ab, die die aktuelle Ausnahme auslöst. (Geerbt von Exception)

Methoden

Name	Beschreibung
Equals(Object)	Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object)
GetBaseException()	Wenn sie in einer abgeleiteten Klasse überschrieben wird, wird die Exception Ursache einer oder mehrerer nachfolgenden Ausnahmen zurückgegeben. (Geerbt von Exception)
GetHashCode()	Dient als Standardhashfunktion. (Geerbt von Object)
GetObjectData(SerializationInfo, StreamingContext)	Wenn sie in einer abgeleiteten Klasse überschrieben wird, werden die SerializationInfo Informationen zur Ausnahme festgelegt. (Geerbt von Exception)
GetType()	Ruft den Laufzeittyp der aktuellen Instanz ab. (Geerbt von Exception)
MemberwiseClone()	Erstellt eine flache Kopie der aktuellen Object. (Geerbt von Object)
ToString()	Erstellt und gibt eine Zeichenfolgendarstellung der aktuellen Ausnahme zurück. (Geerbt von Exception)

Ereignisse

Name	Beschreibung
SerializeObjectState	Tritt auf, wenn eine Ausnahme serialisiert wird, um ein Ausnahmestatusobjekt zu erstellen, das serialisierte Daten zu der Ausnahme enthält. (Geerbt von Exception)

Weitere Informationen

• ReaderWriterLockSlim