ReaderWriterLock.AcquireReaderLock メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
リーダー ロックを取得します。
オーバーロード
| AcquireReaderLock(Int32) |
タイムアウトに Int32 値を使用して、リーダー ロックを取得します。 |
| AcquireReaderLock(TimeSpan) |
タイムアウトに TimeSpan 値を使用して、リーダー ロックを取得します。 |
AcquireReaderLock(Int32)
タイムアウトに Int32 値を使用して、リーダー ロックを取得します。
public:
void AcquireReaderLock(int millisecondsTimeout);public void AcquireReaderLock (int millisecondsTimeout);[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public void AcquireReaderLock (int millisecondsTimeout);member this.AcquireReaderLock : int -> unit[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
member this.AcquireReaderLock : int -> unitPublic Sub AcquireReaderLock (millisecondsTimeout As Integer)パラメーター
- millisecondsTimeout
- Int32
ミリ秒単位のタイムアウト。
- 属性
例外
millisecondsTimeout は、ロック要求が許可される前に期限が切れます。
例
次のコード例は、リーダー ロックを取得して解放する方法と、要求がタイムアウトしたときにスローされる例外を処理する方法を示しています。
このコードは、クラスに提供されるより大きな例の ReaderWriterLock 一部です。
// The complete code is located in the ReaderWriterLock
// class topic.
using namespace System;
using namespace System::Threading;
public ref class Test
{
public:
// Declaring the ReaderWriterLock at the class level
// makes it visible to all threads.
static ReaderWriterLock^ rwl = gcnew ReaderWriterLock;
// For this example, the shared resource protected by the
// ReaderWriterLock is just an integer.
static int resource = 0;
// 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
// Shows how to request and release a reader lock, and
// how to 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( String::Format( "reads resource value {0}", resource ) );
Interlocked::Increment( reads );
}
finally
{
// Ensure that the lock is released.
rwl->ReleaseReaderLock();
}
}
catch ( ApplicationException^ )
{
// The reader lock request timed out.
Interlocked::Increment( readerTimeouts );
}
}
// 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 を複数回呼び出すことができます。これによって、毎回ロックカウントがインクリメントされます。 呼び出すたびに 1 回呼び出 ReleaseReaderLock す AcquireReaderLock必要があります。 または、呼び出 ReleaseLock してロック数をすぐに 0 に減らすことができます。
再帰的ロック要求は、要求スレッドをリーダー キューに配置せずに、常にすぐに許可されます。 書き込みロック要求を長時間ブロックしないように、再帰的ロックは注意して使用してください。
有効なタイムアウト値については、次を参照してください ReaderWriterLock。
こちらもご覧ください
適用対象
AcquireReaderLock(TimeSpan)
タイムアウトに TimeSpan 値を使用して、リーダー ロックを取得します。
public:
void AcquireReaderLock(TimeSpan timeout);public void AcquireReaderLock (TimeSpan timeout);[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public void AcquireReaderLock (TimeSpan timeout);member this.AcquireReaderLock : TimeSpan -> unit[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
member this.AcquireReaderLock : TimeSpan -> unitPublic Sub AcquireReaderLock (timeout As TimeSpan)パラメーター
- timeout
- TimeSpan
タイムアウト期間を指定する TimeSpan。
- 属性
例外
timeout は、ロック要求が許可される前に期限が切れます。
timeout は、-1 ミリ秒以外の負の値を指定します。
注釈
AcquireReaderLock は、別のスレッドがライター ロックを持っている場合、または少なくとも 1 つのスレッドがライター ロックを待機している場合にブロックします。
注意
現在のスレッドにライター ロックが既にある場合、リーダー ロックは取得されません。 代わりに、ライター ロックのロック数が増加します。 これにより、スレッドが独自のライター ロックをブロックできなくなります。 結果は呼び出し AcquireWriterLockとまったく同じであり、ライター ロックを解放するときに追加の呼び出し ReleaseWriterLock が必要です。
AcquireReaderLock は、再帰的なリーダー ロック要求をサポートします。 つまり、スレッドは AcquireReaderLock を複数回呼び出すことができます。これによって、毎回ロックカウントがインクリメントされます。 呼び出すたびに 1 回呼び出 ReleaseReaderLock す AcquireReaderLock必要があります。 または、呼び出 ReleaseLock してロック数をすぐに 0 に減らすことができます。
再帰的ロック要求は、要求スレッドをリーダー キューに配置せずに、常にすぐに許可されます。 書き込みロック要求を長時間ブロックしないように、再帰的ロックは注意して使用してください。
有効なタイムアウト値については、次を参照してください ReaderWriterLock。