LockRecursionException Třída

Definice

Obor názvů:

System.Threading

Sestavení:

System.Threading.dll

Sestavení:

System.Core.dll

Sestavení:

mscorlib.dll

Sestavení:

netstandard.dll

Výjimka, která se vyvolá, když rekurzivní vstup do zámku není kompatibilní se zásadami rekurze pro zámek.

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

Dědičnost

Object

Exception

LockRecursionException

Atributy

SerializableAttribute

Příklady

Následující příklad ukazuje dvě příčiny LockRecursionException při použití ReaderWriterLockSlim třídy. Program vytvoří ReaderWriterLockSlim pomocí konstruktoru bez parametrů, který zakáže rekurzi. Program pak spustí vlákno, které přejde do zámku v režimu čtení. Vlákno se pokusí vstoupit do zámku rekurzivně v režimu čtení a zachytí výslednou výjimku. Nakonec se vlákno pokusí vstoupit do režimu zápisu, což by vytvořilo potenciál pro zablokování. Vlákno zachytí výslednou výjimku.

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

Poznámky

LockRecursionException je vyvolán z několika důvodů, včetně následujících:

• Pokud se vlákno pokusí zadat instanci ReaderWriterLockSlim rekurzivně, ale instance nepodporuje rekurzi.

• Pokud se vlákno pokusí vstoupit do ReaderWriterLockSlim instance v režimu zápisu nebo upgradovatelný režim, když vlákno původně vstoupilo do zámku v režimu čtení. To představuje potenciální zablokování, a proto není povoleno.

• Pokud by povolení jedné úrovně rekurze překročilo maximální hodnotu pro čítač interního úložiště, který se používá ke sledování rekurzí. Tento limit je tak velký, že by se na ni aplikace nikdy neměly setkat.

Konstruktory

LockRecursionException()	Inicializuje novou instanci LockRecursionException třídy se zprávou zadanou systémem, která popisuje chybu.
LockRecursionException(SerializationInfo, StreamingContext)	Inicializuje novou instanci třídy LockRecursionException se serializovanými daty.
LockRecursionException(String)	Inicializuje novou instanci LockRecursionException třídy se zadanou zprávou, která popisuje chybu.
LockRecursionException(String, Exception)	Inicializuje novou instanci LockRecursionException třídy se zadanou chybovou zprávou a odkazem na vnitřní výjimku, která je příčinou této výjimky.

Vlastnosti

Data	Získá kolekci párů klíč/hodnota, které poskytují další uživatelem definované informace o výjimce. (Zděděno od Exception)
HelpLink	Získá nebo nastaví odkaz na soubor nápovědy přidružený k této výjimce. (Zděděno od Exception)
HResult	Získá nebo nastaví HRESULT, kódovanou číselnou hodnotu přiřazenou konkrétní výjimce. (Zděděno od Exception)
InnerException	Exception Získá instanci, která způsobila aktuální výjimku. (Zděděno od Exception)
Message	Získá zprávu, která popisuje aktuální výjimku. (Zděděno od Exception)
Source	Získá nebo nastaví název aplikace nebo objektu, který způsobuje chybu. (Zděděno od Exception)
StackTrace	Získá řetězcové znázornění okamžitých rámců v zásobníku volání. (Zděděno od Exception)
TargetSite	Získá metodu, která vyvolá aktuální výjimku. (Zděděno od Exception)

Metody

Equals(Object)	Určí, zda se zadaný objekt rovná aktuálnímu objektu. (Zděděno od Object)
GetBaseException()	Při přepsání v odvozené třídě vrátí Exception hodnotu, která je hlavní příčinou jedné nebo více následných výjimek. (Zděděno od Exception)
GetHashCode()	Slouží jako výchozí funkce hash. (Zděděno od Object)
GetObjectData(SerializationInfo, StreamingContext)	Při přepsání v odvozené třídě nastaví s SerializationInfo informacemi o výjimce. (Zděděno od Exception)
GetType()	Získá typ modulu runtime aktuální instance. (Zděděno od Exception)
MemberwiseClone()	Vytvoří použádnou kopii aktuálního souboru Object. (Zděděno od Object)
ToString()	Vytvoří a vrátí řetězcovou reprezentaci aktuální výjimky. (Zděděno od Exception)

událost

SerializeObjectState

Zastaralé. Nastane, když je výjimka serializována k vytvoření objektu stavu výjimky, který obsahuje serializovaná data o výjimce. (Zděděno od Exception)

Viz také

• ReaderWriterLockSlim