ReaderWriterLock.AcquireReaderLock Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Erhält eine Lesesperre.
Überlädt
AcquireReaderLock(Int32) |
Erhält eine Lesesperre unter Verwendung eines Int32-Werts für das Timeout. |
AcquireReaderLock(TimeSpan) |
Erhält eine Lesesperre unter Verwendung eines TimeSpan-Werts für das Timeout. |
AcquireReaderLock(Int32)
- Quelle:
- ReaderWriterLock.cs
- Quelle:
- ReaderWriterLock.cs
- Quelle:
- ReaderWriterLock.cs
Erhält eine Lesesperre unter Verwendung eines Int32-Werts für das Timeout.
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 -> unit
Public Sub AcquireReaderLock (millisecondsTimeout As Integer)
Parameter
- millisecondsTimeout
- Int32
Das Timeout in Millisekunden.
- Attribute
Ausnahmen
millisecondsTimeout
läuft ab, bevor die Sperranforderung erteilt wird.
Beispiele
Im folgenden Codebeispiel wird veranschaulicht, wie eine Lesersperre abgerufen und freigegeben wird und wie die Ausnahme behandelt wird, die ausgelöst wird, wenn eine Anforderung ein Zeitüberschreitung aufweist.
Dieser Code ist Teil eines größeren Beispiels, das für die ReaderWriterLock -Klasse bereitgestellt wird.
// 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
Hinweise
AcquireReaderLock blockiert, wenn ein anderer Thread über die Writer-Sperre verfügt oder mindestens ein Thread auf die Writer-Sperre wartet.
Hinweis
Wenn der aktuelle Thread bereits über die Writer-Sperre verfügt, wird keine Lesersperre abgerufen. Stattdessen wird die Sperranzahl für die Writer-Sperre erhöht. Dadurch wird verhindert, dass ein Thread für eine eigene Writer-Sperre blockiert wird. Das Ergebnis entspricht genau dem Aufrufen AcquireWriterLockvon, und beim Freigeben der Writer-Sperre ist ein zusätzlicher Aufruf ReleaseWriterLock von erforderlich.
AcquireReaderLock
unterstützt rekursive Lesersperranforderungen. Das heißt, ein Thread kann AcquireReaderLock mehrmals aufrufen, wodurch die Sperranzahl jedes Mal erhöht wird. Sie müssen einmal für jedes Mal aufrufen ReleaseReaderLock , wenn Sie aufrufen AcquireReaderLock
. Alternativ können Sie aufrufen ReleaseLock , um die Sperranzahl sofort auf 0 zu reduzieren.
Rekursive Sperranforderungen werden immer sofort gewährt, ohne den anfordernden Thread in der Leserwarteschlange zu platzieren. Verwenden Sie rekursive Sperren mit Vorsicht, um zu vermeiden, dass Writer-Sperren-Anforderungen für lange Zeiträume blockiert werden.
Gültige Timeoutwerte finden Sie unter ReaderWriterLock.
Weitere Informationen
Gilt für:
AcquireReaderLock(TimeSpan)
- Quelle:
- ReaderWriterLock.cs
- Quelle:
- ReaderWriterLock.cs
- Quelle:
- ReaderWriterLock.cs
Erhält eine Lesesperre unter Verwendung eines TimeSpan-Werts für das Timeout.
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 -> unit
Public Sub AcquireReaderLock (timeout As TimeSpan)
Parameter
- timeout
- TimeSpan
Eine TimeSpan
, die den Timeoutzeitraum angibt.
- Attribute
Ausnahmen
timeout
läuft ab, bevor die Sperranforderung erteilt wird.
timeout
gibt einen negativen Wert ungleich -1 Millisekunden an.
Hinweise
AcquireReaderLock blockiert, wenn ein anderer Thread über die Writer-Sperre verfügt oder mindestens ein Thread auf die Writer-Sperre wartet.
Hinweis
Wenn der aktuelle Thread bereits über die Writer-Sperre verfügt, wird keine Lesersperre abgerufen. Stattdessen wird die Sperranzahl für die Writer-Sperre erhöht. Dadurch wird verhindert, dass ein Thread für eine eigene Writer-Sperre blockiert wird. Das Ergebnis entspricht genau dem Aufrufen AcquireWriterLockvon, und beim Freigeben der Writer-Sperre ist ein zusätzlicher Aufruf ReleaseWriterLock von erforderlich.
AcquireReaderLock
unterstützt rekursive Lesersperranforderungen. Das heißt, ein Thread kann AcquireReaderLock mehrmals aufrufen, wodurch die Sperranzahl jedes Mal erhöht wird. Sie müssen einmal für jedes Mal aufrufen ReleaseReaderLock , wenn Sie aufrufen AcquireReaderLock
. Alternativ können Sie aufrufen ReleaseLock , um die Sperranzahl sofort auf 0 zu reduzieren.
Rekursive Sperranforderungen werden immer sofort gewährt, ohne den anfordernden Thread in der Leserwarteschlange zu platzieren. Verwenden Sie rekursive Sperren mit Vorsicht, um zu vermeiden, dass Writer-Sperren-Anforderungen für lange Zeiträume blockiert werden.
Gültige Timeoutwerte finden Sie unter ReaderWriterLock.