ReaderWriterLockSlim.EnterWriteLock 方法

定義

嘗試進入寫入模式的鎖定。

public void EnterWriteLock();

例外狀況

RecursionPolicy 屬性為 NoRecursion,且目前的執行緒已進入任何模式的鎖定狀態。

-或-

目前的執行緒已進入真實模式,而且還沒有擁有寫入鎖定,因此嘗試進入寫入模式鎖定可能會造成死結。

-或-

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

範例

下列範例示範如何使用 EnterWriteLock 方法來在寫入模式中進入鎖定。 範例中顯示的 方法會將新的索引鍵/值組新增至同步快取。 如果索引鍵已經在快取中,內部擲回的 Dictionary<TKey,TValue> 例外狀況會允許終止 方法。 finally區塊可用來執行 ExitWriteLock 方法,以確保呼叫端結束寫入模式。

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

private ReaderWriterLockSlim cacheLock = new ReaderWriterLockSlim();
private Dictionary<int, string> innerCache = new Dictionary<int, string>();
public void Add(int key, string value)
{
    cacheLock.EnterWriteLock();
    try
    {
        innerCache.Add(key, value);
    }
    finally
    {
        cacheLock.ExitWriteLock();
    }
}

備註

這個方法會封鎖直到呼叫執行緒進入鎖定為止,因此可能永遠不會傳回。 TryEnterWriteLock使用 方法來封鎖指定的間隔,然後在呼叫執行緒未在該間隔期間進入寫入模式時傳回 。

如果其他執行緒在讀取模式中進入鎖定,呼叫 方法的 EnterWriteLock 執行緒會封鎖,直到這些執行緒結束讀取模式為止。 當有線程等候進入寫入模式時,嘗試進入讀取模式或可升級模式的其他執行緒會封鎖,直到所有等候進入寫入模式的執行緒逾時或進入寫入模式,然後從中結束為止。

注意

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

適用於

產品 版本
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9, 10
.NET Framework 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0