LockRecursionException 類別

定義

命名空間:

System.Threading

組件:

mscorlib.dll

當遞迴進入鎖與該鎖的遞迴策略不相容時，拋出的例外。

public ref class LockRecursionException : Exception

[System.Serializable]
public class LockRecursionException : Exception

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

Public Class LockRecursionException
Inherits Exception

繼承

Object

Exception

LockRecursionException

屬性

SerializableAttribute

範例

以下範例展示了使用該ReaderWriterLockSlim類別時的LockRecursionException兩個原因。 程式透過使用無參數建構子來建立 ， 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 實例，而執行緒最初以讀取模式進入鎖。 這代表潛在的僵局，因此不被允許。

• 如果允許多一層遞迴，會超過用於追蹤遞迴的內部儲存計數器的最大值。 這個限制非常大，應用程式根本不應該遇到。

建構函式

名稱	Description
LockRecursionException()	初始化該類別的新實例 LockRecursionException ，並以系統提供的訊息描述錯誤。
LockRecursionException(SerializationInfo, StreamingContext)	使用串行化數據，初始化 LockRecursionException 類別的新實例。
LockRecursionException(String, Exception)	初始化類別的新實例 LockRecursionException ，並附上指定的錯誤訊息及導致該異常的內部例外的參考。
LockRecursionException(String)	初始化類別的新實例 LockRecursionException ，並以指定訊息描述錯誤。

屬性

名稱	Description
Data	取得索引鍵/值組的集合，提供例外狀況的其他使用者定義資訊。 (繼承來源 Exception)
HelpLink	取得或設定與這個例外狀況相關聯的說明檔連結。 (繼承來源 Exception)
HResult	取得或設定 HRESULT，這是指派給特定例外狀況的編碼數值。 (繼承來源 Exception)
InnerException	會取得 Exception 造成目前例外的實例。 (繼承來源 Exception)
Message	取得描述目前例外狀況的訊息。 (繼承來源 Exception)
Source	取得或設定造成錯誤之應用程式或物件的名稱。 (繼承來源 Exception)
StackTrace	取得呼叫堆疊上即時框架的字串表示。 (繼承來源 Exception)
TargetSite	取得擲回目前例外狀況的方法。 (繼承來源 Exception)

方法

名稱	Description
Equals(Object)	判斷指定的 物件是否等於目前的物件。 (繼承來源 Object)
GetBaseException()	當在派生類別中被覆寫時，回傳 Exception 是一個或多個後續例外的根因。 (繼承來源 Exception)
GetHashCode()	做為預設雜湊函式。 (繼承來源 Object)
GetObjectData(SerializationInfo, StreamingContext)	在衍生類別中覆寫時，使用例外狀況的相關信息來設定 SerializationInfo。 (繼承來源 Exception)
GetType()	取得目前實例的運行時間類型。 (繼承來源 Exception)
MemberwiseClone()	建立目前 Object的淺層複本。 (繼承來源 Object)
ToString()	建立並傳回目前例外狀況的字串表示。 (繼承來源 Exception)

事件

名稱	Description
SerializeObjectState	發生於例外狀況串行化以建立例外狀況狀態物件，其中包含例外狀況的串行化數據。 (繼承來源 Exception)

另請參閱

• ReaderWriterLockSlim