LockRecursionException Klasa

Definicja

Przestrzeń nazw:

System.Threading

Zestaw:

mscorlib.dll

Wyjątek zgłaszany, gdy rekursywny wpis w blokadzie nie jest zgodny z zasadami rekursji dla blokady.

public ref class LockRecursionException : Exception

[System.Serializable]
public class LockRecursionException : Exception

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

Public Class LockRecursionException
Inherits Exception

Dziedziczenie

Object

Exception

LockRecursionException

Atrybuty

SerializableAttribute

Przykłady

W poniższym przykładzie przedstawiono dwie przyczyny LockRecursionException użycia ReaderWriterLockSlim klasy. Program tworzy obiekt ReaderWriterLockSlim przy użyciu konstruktora bez parametrów, który nie zezwala na rekursję. Następnie program uruchamia wątek, który wprowadza blokadę w trybie odczytu. Wątek próbuje wprowadzić blokadę rekursywnie w trybie odczytu i przechwytuje wynikowy wyjątek. Na koniec wątek próbuje wprowadzić tryb zapisu, co stworzyłoby potencjał zakleszczenia. Wątek przechwytuje wynikowy wyjątek.

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

Uwagi

LockRecursionException jest zgłaszany z kilku powodów, w tym z następujących:

• Jeśli wątek próbuje wprowadzić wystąpienie ReaderWriterLockSlim cyklicznie, ale wystąpienie nie obsługuje rekursji.

• Jeśli wątek próbuje wprowadzić ReaderWriterLockSlim wystąpienie w trybie zapisu lub tryb uaktualniania, gdy wątek początkowo wprowadził blokadę w trybie odczytu. Oznacza to potencjalny zakleszczenie i dlatego nie jest dozwolone.

• Jeśli zezwolenie na jeszcze jeden poziom rekursji przekroczy maksymalną wartość licznika magazynu wewnętrznego używanego do śledzenia rekursji. Ten limit jest tak duży, że aplikacje nigdy nie powinny go napotkać.

Konstruktory

Nazwa	Opis
LockRecursionException()	Inicjuje nowe wystąpienie klasy LockRecursionException z komunikatem dostarczonym przez system, który opisuje błąd.
LockRecursionException(SerializationInfo, StreamingContext)	Inicjuje LockRecursionException nowe wystąpienie klasy z serializowanymi danymi.
LockRecursionException(String, Exception)	Inicjuje nowe wystąpienie LockRecursionException klasy z określonym komunikatem o błędzie i odwołaniem do wyjątku wewnętrznego, który jest przyczyną tego wyjątku.
LockRecursionException(String)	Inicjuje nowe wystąpienie klasy LockRecursionException z określonym komunikatem opisujący błąd.

Właściwości

Nazwa	Opis
Data	Pobiera kolekcję par klucz/wartość, które zapewniają dodatkowe informacje zdefiniowane przez użytkownika dotyczące wyjątku. (Odziedziczone po Exception)
HelpLink	Pobiera lub ustawia link do pliku pomocy skojarzonego z tym wyjątkiem. (Odziedziczone po Exception)
HResult	Pobiera lub ustawia HRESULT, zakodowaną wartość liczbową przypisaną do określonego wyjątku. (Odziedziczone po Exception)
InnerException	Exception Pobiera wystąpienie, które spowodowało bieżący wyjątek. (Odziedziczone po Exception)
Message	Pobiera komunikat opisujący bieżący wyjątek. (Odziedziczone po Exception)
Source	Pobiera lub ustawia nazwę aplikacji lub obiektu, który powoduje błąd. (Odziedziczone po Exception)
StackTrace	Pobiera reprezentację ciągu natychmiastowych ramek na stosie wywołań. (Odziedziczone po Exception)
TargetSite	Pobiera metodę, która zgłasza bieżący wyjątek. (Odziedziczone po Exception)

Metody

Nazwa	Opis
Equals(Object)	Określa, czy dany obiekt jest taki sam, jak bieżący obiekt. (Odziedziczone po Object)
GetBaseException()	Po zastąpieniu w klasie pochodnej funkcja zwraca Exception główną przyczynę co najmniej jednego kolejnego wyjątku. (Odziedziczone po Exception)
GetHashCode()	Służy jako domyślna funkcja skrótu. (Odziedziczone po Object)
GetObjectData(SerializationInfo, StreamingContext)	Po przesłonięciu w klasie pochodnej ustawia element SerializationInfo z informacjami o wyjątku. (Odziedziczone po Exception)
GetType()	Pobiera typ środowiska uruchomieniowego bieżącego wystąpienia. (Odziedziczone po Exception)
MemberwiseClone()	Tworzy płytkią kopię bieżącego Object. (Odziedziczone po Object)
ToString()	Tworzy i zwraca reprezentację ciągu bieżącego wyjątku. (Odziedziczone po Exception)

Zdarzenia

Nazwa	Opis
SerializeObjectState	Występuje, gdy wyjątek jest serializowany w celu utworzenia obiektu stanu wyjątku zawierającego serializowane dane dotyczące wyjątku. (Odziedziczone po Exception)

Zobacz też

• ReaderWriterLockSlim