LockRecursionException Класс

Определение

Пространство имен:

System.Threading

Сборка:

System.Threading.dll

Сборка:

System.Core.dll

Сборка:

mscorlib.dll

Сборка:

netstandard.dll

Исключение, которое создается, когда рекурсивная запись блокировки не совместима с рекурсивной политикой блокировки.

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

Наследование

Object

Exception

LockRecursionException

Атрибуты

SerializableAttribute

Примеры

В следующем примере показаны две причины LockRecursionException использования ReaderWriterLockSlim класса. Программа создает объект ReaderWriterLockSlim с помощью конструктора без параметров, который запрещает рекурсию. Затем программа запускает поток, который входит в блокировку в режиме чтения. Поток пытается ввести блокировку рекурсивно в режиме чтения и перехватывает полученное исключение. Наконец, поток пытается войти в режим записи, который создаст потенциал для взаимоблокировок. Поток перехватывает результирующее исключение.

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

Комментарии

LockRecursionException возникает по нескольким причинам, в том числе по следующим причинам:

• Если поток пытается ввести экземпляр ReaderWriterLockSlim рекурсивно, но экземпляр не поддерживает рекурсию.

• Если поток пытается войти ReaderWriterLockSlim в экземпляр в режиме записи или в режиме обновления, когда поток изначально вошел в блокировку в режиме чтения. Это представляет собой потенциальную взаимоблокировку и, следовательно, не допускается.

• Если разрешение еще одного уровня рекурсии превысит максимальное значение для внутреннего счетчика хранилища, используемого для отслеживания рекурсий. Это ограничение настолько велико, что оно не должно достигаться приложениями на практике.

Конструкторы

LockRecursionException()	Инициализирует новый экземпляр класса LockRecursionException с предоставленным системой описанием ошибки.
LockRecursionException(SerializationInfo, StreamingContext)	Инициализирует новый экземпляр класса LockRecursionException с сериализованными данными.
LockRecursionException(String)	Инициализирует новый экземпляр класса LockRecursionException с указанным описанием ошибки.
LockRecursionException(String, Exception)	Инициализирует новый экземпляр класса LockRecursionException указанным сообщением об ошибке и ссылкой на внутреннее исключение, вызвавшее данное исключение.

Свойства

Data	Возвращает коллекцию пар «ключ-значение», предоставляющую дополнительные сведения об исключении. (Унаследовано от Exception)
HelpLink	Получает или задает ссылку на файл справки, связанный с этим исключением. (Унаследовано от Exception)
HResult	Возвращает или задает HRESULT — кодированное числовое значение, присвоенное определенному исключению. (Унаследовано от Exception)
InnerException	Возвращает экземпляр класса Exception, который вызвал текущее исключение. (Унаследовано от Exception)
Message	Возвращает сообщение, описывающее текущее исключение. (Унаследовано от Exception)
Source	Возвращает или задает имя приложения или объекта, вызывавшего ошибку. (Унаследовано от Exception)
StackTrace	Получает строковое представление непосредственных кадров в стеке вызова. (Унаследовано от Exception)
TargetSite	Возвращает метод, создавший текущее исключение. (Унаследовано от Exception)

Методы

Equals(Object)	Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object)
GetBaseException()	При переопределении в производном классе возвращает исключение Exception, которое является первопричиной одного или нескольких последующих исключений. (Унаследовано от Exception)
GetHashCode()	Служит хэш-функцией по умолчанию. (Унаследовано от Object)
GetObjectData(SerializationInfo, StreamingContext)	При переопределении в производном классе задает объект SerializationInfo со сведениями об исключении. (Унаследовано от Exception)
GetType()	Возвращает тип среды выполнения текущего экземпляра. (Унаследовано от Exception)
MemberwiseClone()	Создает неполную копию текущего объекта Object. (Унаследовано от Object)
ToString()	Создает и возвращает строковое представление текущего исключения. (Унаследовано от Exception)

События

SerializeObjectState

Является устаревшей. Возникает, когда исключение сериализовано для создания объекта состояния исключения, содержащего сериализованные данные об исключении. (Унаследовано от Exception)

См. также раздел

• ReaderWriterLockSlim