ReaderWriterLockSlim.TryEnterWriteLock メソッド

public:
 bool TryEnterWriteLock(int millisecondsTimeout);

public bool TryEnterWriteLock(int millisecondsTimeout);

member this.TryEnterWriteLock : int -> bool

Public Function TryEnterWriteLock (millisecondsTimeout As Integer) As Boolean

パラメーター

返品

true 呼び出し元のスレッドが書き込みモードに入った場合は false。

例外

例

次の例は、 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 メソッドを呼び出すスレッドは、それらのスレッドが読み取りモードを終了するまで、またはタイムアウト間隔が経過するまでブロックします。 スレッドが書き込みモードに入るのを待機している間にブロックされますが、書き込みモードに入るのを待機しているすべてのスレッドがタイムアウトになるか、書き込みモードに入ってから終了するまで、読み取りモードまたはアップグレード可能モードに入ろうとする追加のスレッドがブロックされます。

public:
 bool TryEnterWriteLock(TimeSpan timeout);

public bool TryEnterWriteLock(TimeSpan timeout);

member this.TryEnterWriteLock : TimeSpan -> bool

Public Function TryEnterWriteLock (timeout As TimeSpan) As Boolean

パラメーター

返品

true 呼び出し元のスレッドが書き込みモードに入った場合は false。

例外

注釈

timeoutが 0 (ゼロ) の場合、このメソッドはロック状態を確認し、目的の状態が使用できない場合は直ちにfalseを返します。

他のスレッドが読み取りモードでロックに入った場合、 TryEnterWriteLock メソッドを呼び出すスレッドは、それらのスレッドが読み取りモードを終了するまで、またはタイムアウト間隔が経過するまでブロックします。 スレッドが書き込みモードに入るのを待機している間にブロックされますが、書き込みモードに入るのを待機しているすべてのスレッドがタイムアウトになるか、書き込みモードに入ってから終了するまで、読み取りモードまたはアップグレード可能モードに入ろうとする追加のスレッドがブロックされます。