ReaderWriterLock.AcquireReaderLock メソッド

定義

名前空間:

System.Threading

アセンブリ:

netstandard.dll, System.Threading.dll

リーダー ロックを取得します。

オーバーロード

名前	説明
AcquireReaderLock(Int32)	タイムアウトの Int32 値を使用して、リーダー ロックを取得します。
AcquireReaderLock(TimeSpan)	タイムアウトの TimeSpan 値を使用して、リーダー ロックを取得します。

AcquireReaderLock(Int32)

ソース:

ReaderWriterLock.cs

タイムアウトの Int32 値を使用して、リーダー ロックを取得します。

public:
 void AcquireReaderLock(int millisecondsTimeout);

[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public void AcquireReaderLock(int millisecondsTimeout);

[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
member this.AcquireReaderLock : int -> unit

Public Sub AcquireReaderLock (millisecondsTimeout As Integer)

パラメーター

millisecondsTimeout

Int32

タイムアウト (ミリ秒単位)。

属性

UnsupportedOSPlatformAttribute

例外

ApplicationException

millisecondsTimeout は、ロック要求が許可される前に期限切れになります。

例

次のコード例は、リーダー ロックを取得して解放する方法と、要求がタイムアウトしたときにスローされる例外を処理する方法を示しています。

このコードは、 ReaderWriterLock クラスに提供されるより大きな例の一部です。

// The complete code is located in the ReaderWriterLock class topic.
using System;
using System.Threading;

public class Example
{
   static ReaderWriterLock rwl = new ReaderWriterLock();
   // Define the shared resource protected by the ReaderWriterLock.
   static int resource = 0;

' The complete code is located in the ReaderWriterLock class topic.
Imports System.Threading

Public Module Example
   Private rwl As New ReaderWriterLock()
   ' Define the shared resource protected by the ReaderWriterLock.
   Private resource As Integer = 0

// Request and release a reader lock, and handle time-outs.
static void ReadFromResource(int timeOut)
{
   try {
      rwl.AcquireReaderLock(timeOut);
      try {
         // It is safe for this thread to read from the shared resource.
         Display("reads resource value " + resource);
         Interlocked.Increment(ref reads);
      }
      finally {
         // Ensure that the lock is released.
         rwl.ReleaseReaderLock();
      }
   }
   catch (ApplicationException) {
      // The reader lock request timed out.
      Interlocked.Increment(ref readerTimeouts);
   }
}

' Request and release a reader lock, and handle time-outs.
Sub ReadFromResource(timeOut As Integer)
   Try
      rwl.AcquireReaderLock(timeOut)
      Try
         ' It's safe for this thread to read from the shared resource.
         Display("reads resource value " & resource)
         Interlocked.Increment(reads)
      Finally
         ' Ensure that the lock is released.
         rwl.ReleaseReaderLock()
      End Try
   Catch ex As ApplicationException
      ' The reader lock request timed out.
      Interlocked.Increment(readerTimeouts)
   End Try
End Sub

}

End Module

注釈

AcquireReaderLock は、別のスレッドがライター ロックを持っている場合、または少なくとも 1 つのスレッドがライター ロックを待機している場合にブロックします。

注

現在のスレッドにライター ロックが既にある場合、リーダー ロックは取得されません。 代わりに、ライター ロックのロック数がインクリメントされます。 これにより、スレッドが独自のライター ロックでブロックされるのを防ぐことができます。 結果は、 AcquireWriterLockの呼び出しとまったく同じであり、ライター ロックを解放するときに、 ReleaseWriterLock の追加の呼び出しが必要です。

AcquireReaderLock は、再帰的なリーダー ロック要求をサポートします。 つまり、スレッドは AcquireReaderLock を複数回呼び出すことができます。この場合、毎回ロックカウントがインクリメントされます。 AcquireReaderLockを呼び出すたびに、ReleaseReaderLockを 1 回呼び出す必要があります。 または、 ReleaseLock を呼び出して、ロック数を直ちにゼロに減らすことができます。

再帰ロック要求は、要求スレッドをリーダー キューに配置せずに、常に直ちに許可されます。 ライター ロック要求が長時間ブロックされないようにするには、注意して再帰ロックを使用してください。

有効なタイムアウト値については、 ReaderWriterLockを参照してください。

こちらもご覧ください

• マネージド スレッド処理
• ReaderWriterLock

AcquireReaderLock(TimeSpan)

ソース:

ReaderWriterLock.cs

タイムアウトの TimeSpan 値を使用して、リーダー ロックを取得します。

public:
 void AcquireReaderLock(TimeSpan timeout);

[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public void AcquireReaderLock(TimeSpan timeout);

[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
member this.AcquireReaderLock : TimeSpan -> unit

Public Sub AcquireReaderLock (timeout As TimeSpan)

パラメーター

timeout

TimeSpan

タイムアウト期間を指定する TimeSpan 。

属性

UnsupportedOSPlatformAttribute

例外

ApplicationException

timeout は、ロック要求が許可される前に期限切れになります。

ArgumentOutOfRangeException

timeout は、-1 ミリ秒以外の負の値を指定します。

注釈

AcquireReaderLock は、別のスレッドがライター ロックを持っている場合、または少なくとも 1 つのスレッドがライター ロックを待機している場合にブロックします。

注

現在のスレッドにライター ロックが既にある場合、リーダー ロックは取得されません。 代わりに、ライター ロックのロック数がインクリメントされます。 これにより、スレッドが独自のライター ロックでブロックされるのを防ぐことができます。 結果は、 AcquireWriterLockの呼び出しとまったく同じであり、ライター ロックを解放するときに、 ReleaseWriterLock の追加の呼び出しが必要です。

AcquireReaderLock は、再帰的なリーダー ロック要求をサポートします。 つまり、スレッドは AcquireReaderLock を複数回呼び出すことができます。この場合、毎回ロックカウントがインクリメントされます。 AcquireReaderLockを呼び出すたびに、ReleaseReaderLockを 1 回呼び出す必要があります。 または、 ReleaseLock を呼び出して、ロック数を直ちにゼロに減らすことができます。

再帰ロック要求は、要求スレッドをリーダー キューに配置せずに、常に直ちに許可されます。 ライター ロック要求が長時間ブロックされないようにするには、注意して再帰ロックを使用してください。

有効なタイムアウト値については、 ReaderWriterLockを参照してください。

こちらもご覧ください

• マネージド スレッド処理
• ReaderWriterLock