ReaderWriterLockSlim.TryEnterWriteLock 方法

定義

命名空間:

System.Threading

組件:

System.Threading.dll

嘗試以選用的逾時，在寫入模式下進入鎖定狀態。

多載

TryEnterWriteLock(Int32)	嘗試以選用的逾時，在寫入模式下進入鎖定狀態。
TryEnterWriteLock(TimeSpan)	嘗試以選用的逾時，在寫入模式下進入鎖定狀態。

TryEnterWriteLock(Int32)

來源:

ReaderWriterLockSlim.cs

嘗試以選用的逾時，在寫入模式下進入鎖定狀態。

public:
 bool TryEnterWriteLock(int millisecondsTimeout);

public bool TryEnterWriteLock (int millisecondsTimeout);

member this.TryEnterWriteLock : int -> bool

Public Function TryEnterWriteLock (millisecondsTimeout As Integer) As Boolean

參數

millisecondsTimeout

Int32

要等候的毫秒數；若要永遠等候，則為 -1 (Infinite)。

傳回

Boolean

如果呼叫的執行緒已進入寫入模式，則為 true，否則為 false。

例外狀況

LockRecursionException

RecursionPolicy 屬性為 NoRecursion，且目前的執行緒已進入鎖定狀態。

-或-

目前執行緒一開始已進入讀取模式的鎖定狀態，因此嘗試進入寫入模式可能會造成死結。

-或-

遞迴的次數會超過計數器的容量。 限制過大，使應用程式永遠不會發生這個情形。

ArgumentOutOfRangeException

millisecondsTimeout 的值為負，但不等於 Infinite (-1)，這是唯一允許的負值。

ObjectDisposedException

ReaderWriterLockSlim 物件已經處置。

範例

下列範例示範如何使用 TryEnterWriteLock 方法，以逾時進入寫入模式的鎖定。範例中顯示的 方法會將新的索引鍵/值組新增至同步快取。 如果指定的逾時間隔線上程進入鎖定之前經過，此方法會傳 false 回 。 如果新增索引鍵/值組，方法會 true 傳回 。

如果索引鍵已經在快取中，則內部 Dictionary<TKey,TValue> 擲回的例外狀況允許終止 方法。 finally區塊是用來執行 ExitWriteLock 方法，以確保呼叫端結束鎖定。

此程式碼是提供給 類別之較大範例的 ReaderWriterLockSlim 一部分。

private ReaderWriterLockSlim cacheLock = new ReaderWriterLockSlim();
private Dictionary<int, string> innerCache = new Dictionary<int, string>();

Private cacheLock As New ReaderWriterLockSlim()
Private innerCache As New Dictionary(Of Integer, String)

public bool AddWithTimeout(int key, string value, int timeout)
{
    if (cacheLock.TryEnterWriteLock(timeout))
    {
        try
        {
            innerCache.Add(key, value);
        }
        finally
        {
            cacheLock.ExitWriteLock();
        }
        return true;
    }
    else
    {
        return false;
    }
}

Public Function AddWithTimeout(ByVal key As Integer, ByVal value As String, _
                               ByVal timeout As Integer) As Boolean
    If cacheLock.TryEnterWriteLock(timeout) Then
        Try
            innerCache.Add(key, value)
        Finally
            cacheLock.ExitWriteLock()
        End Try
        Return True
    Else
        Return False
    End If
End Function

備註

如果 millisecondsTimeout 為 0 (零) ，這個方法會檢查鎖定狀態，並在所需的狀態無法使用時立即傳回 false 。

如果其他執行緒在讀取模式中進入鎖定，則會呼叫 TryEnterWriteLock 方法的執行緒會封鎖，直到這些執行緒結束讀取模式，或直到逾時間隔經過為止。 當執行緒在等候進入寫入模式時，嘗試進入讀取模式或可升級模式區塊的其他執行緒，直到所有等候進入寫入模式的執行緒逾時或進入寫入模式，然後結束寫入模式為止。

注意

如果鎖定允許遞迴，在寫入模式中進入鎖定的執行緒可以遞迴進入寫入模式，即使其他執行緒正在等候進入寫入模式也一樣。

TryEnterWriteLock(TimeSpan)

來源:

ReaderWriterLockSlim.cs

嘗試以選用的逾時，在寫入模式下進入鎖定狀態。

public:
 bool TryEnterWriteLock(TimeSpan timeout);

public bool TryEnterWriteLock (TimeSpan timeout);

member this.TryEnterWriteLock : TimeSpan -> bool

Public Function TryEnterWriteLock (timeout As TimeSpan) As Boolean

參數

timeout

TimeSpan

等待的間隔，或 -1 毫秒無限期等待。

傳回

Boolean

如果呼叫的執行緒已進入寫入模式，則為 true，否則為 false。

例外狀況

LockRecursionException

RecursionPolicy 屬性為 NoRecursion，且目前的執行緒已進入鎖定狀態。

-或-

目前執行緒一開始已進入讀取模式的鎖定狀態，因此嘗試進入寫入模式可能會造成死結。

-或-

遞迴的次數會超過計數器的容量。 限制過大，使應用程式永遠不會發生這個情形。

ArgumentOutOfRangeException

timeout 的值為負，但不等於 -1 毫秒，這是唯一允許的負值。

-或-

的值 timeout 大於 Int32.MaxValue 毫秒。

ObjectDisposedException

ReaderWriterLockSlim 物件已經處置。

備註

如果 timeout 為 0 (零) ，這個方法會檢查鎖定狀態，並在所需的狀態無法使用時立即傳回 false 。

如果其他執行緒在讀取模式中進入鎖定，則會呼叫 TryEnterWriteLock 方法的執行緒會封鎖，直到這些執行緒結束讀取模式，或直到逾時間隔經過為止。 當執行緒在等候進入寫入模式時，嘗試進入讀取模式或可升級模式區塊的其他執行緒，直到所有等候進入寫入模式的執行緒逾時或進入寫入模式，然後結束寫入模式為止。

注意

如果鎖定允許遞迴，在寫入模式中進入鎖定的執行緒可以遞迴進入寫入模式，即使其他執行緒正在等候進入寫入模式也一樣。