LockRecursionException Klasa

Definicja

Przestrzeń nazw:

System.Threading

Zestaw:

System.Threading.dll

Zestaw:

System.Core.dll

Zestaw:

mscorlib.dll

Zestaw:

netstandard.dll

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

public ref class LockRecursionException : Exception

public class LockRecursionException : Exception

[System.Serializable]
public class LockRecursionException : Exception

type LockRecursionException = class
    inherit 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 ReaderWriterLockSlim obiekt przy użyciu konstruktora bez parametrów, który nie zezwala na rekursję. Następnie program uruchamia wątek, który przechodzi do blokady w trybie odczytu. Wątek próbuje cyklicznie wprowadzić blokadę w trybie odczytu i przechwytuje wynikowy wyjątek. Na koniec wątek próbuje wejść w 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 parametr jest zgłaszany z kilku powodów, w tym z następujących powodów:

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

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

• 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

LockRecursionException()	Inicjuje LockRecursionException nowe wystąpienie klasy z komunikatem dostarczonym przez system, który opisuje błąd.
LockRecursionException(SerializationInfo, StreamingContext)	Inicjuje nowe wystąpienie klasy LockRecursionException z zserializowanymi danymi.
LockRecursionException(String)	Inicjuje LockRecursionException nowe wystąpienie klasy z określonym komunikatem opisujący błąd.
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.

Właściwości

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 w stosie wywołań. (Odziedziczone po Exception)
TargetSite	Pobiera metodę, która zgłasza bieżący wyjątek. (Odziedziczone po Exception)

Metody

Equals(Object)	Określa, czy dany obiekt jest taki sam, jak bieżący obiekt. (Odziedziczone po Object)
GetBaseException()	Po przesłonięciu 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 zastąpieniu w klasie pochodnej ustawia SerializationInfo element 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 Objectelementu . (Odziedziczone po Object)
ToString()	Tworzy i zwraca reprezentację ciągu bieżącego wyjątku. (Odziedziczone po Exception)

Zdarzenia

SerializeObjectState

Nieaktualne. Występuje, gdy wyjątek jest serializowany w celu utworzenia obiektu stanu wyjątku zawierającego serializowane dane o wyjątku. (Odziedziczone po Exception)

Zobacz też

• ReaderWriterLockSlim