ReaderWriterLock.AcquireReaderLock Methode

Definition

Namespace:

System.Threading

Assemblys:

netstandard.dll, System.Threading.dll

Erwirbt eine Lesesperre.

Überlädt

Name	Beschreibung
AcquireReaderLock(Int32)	Dient zum Abrufen einer Lesesperre mit einem Int32 Wert für das Timeout.
AcquireReaderLock(TimeSpan)	Dient zum Abrufen einer Lesesperre mit einem TimeSpan Wert für das Timeout.

AcquireReaderLock(Int32)

Quelle:

ReaderWriterLock.cs

Dient zum Abrufen einer Lesesperre mit einem Int32 Wert für das Timeout.

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)

Parameter

millisecondsTimeout

Int32

Das Timeout in Millisekunden.

Attribute

UnsupportedOSPlatformAttribute

Ausnahmen

ApplicationException

millisecondsTimeout läuft ab, bevor die Sperranforderung erteilt wird.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie eine Lese-/Lesesperre erworben und freigegeben wird und wie die Ausnahme behandelt wird, die ausgelöst wird, wenn eine Anforderung ein Zeitüberschreitung auftritt.

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 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

Hinweise

AcquireReaderLock blockiert, wenn ein anderer Thread über die Writer-Sperre verfügt oder mindestens ein Thread auf die Writer-Sperre wartet.

Note

Wenn der aktuelle Thread bereits über die Writer-Sperre verfügt, wird keine Lesesperre abgerufen. Stattdessen wird die Sperranzahl für die Writer-Sperre erhöht. Dadurch wird verhindert, dass ein Thread auf seiner eigenen Writer-Sperre blockiert wird. Das Ergebnis entspricht genau dem Aufrufen AcquireWriterLock, und ein zusätzlicher Aufruf ReleaseWriterLock ist erforderlich, wenn die Writer-Sperre freigegeben wird.

AcquireReaderLock unterstützt rekursive Lese-/Lesesperranforderungen. Das heißt, ein Thread kann AcquireReaderLock mehrmals aufrufen, wodurch die Sperranzahl jedes Mal erhöht wird. Sie müssen jedes Mal einmal anrufen ReleaseReaderLock , wenn Sie anrufen AcquireReaderLock. Alternativ können Sie aufrufen ReleaseLock , um die Sperranzahl sofort auf Null zu reduzieren.

Rekursive Sperranforderungen werden immer sofort gewährt, ohne den anfordernden Thread in der Lesewarteschlange zu platzieren. Verwenden Sie rekursive Sperren mit Vorsicht, um das Blockieren von Schreibsperranforderungen für lange Zeiträume zu vermeiden.

Gültige Timeoutwerte finden Sie unter ReaderWriterLock.

Weitere Informationen

• Verwaltetes Thread-Management
• Readerwriterlock

AcquireReaderLock(TimeSpan)

Quelle:

ReaderWriterLock.cs

Dient zum Abrufen einer Lesesperre mit einem TimeSpan Wert für das Timeout.

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)

Parameter

timeout

TimeSpan

Ein TimeSpan Angeben des Timeoutzeitraums.

Attribute

UnsupportedOSPlatformAttribute

Ausnahmen

ApplicationException

timeout läuft ab, bevor die Sperranforderung erteilt wird.

ArgumentOutOfRangeException

timeout Gibt einen anderen negativen Wert als -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.

Note

Wenn der aktuelle Thread bereits über die Writer-Sperre verfügt, wird keine Lesesperre abgerufen. Stattdessen wird die Sperranzahl für die Writer-Sperre erhöht. Dadurch wird verhindert, dass ein Thread auf seiner eigenen Writer-Sperre blockiert wird. Das Ergebnis entspricht genau dem Aufrufen AcquireWriterLock, und ein zusätzlicher Aufruf ReleaseWriterLock ist erforderlich, wenn die Writer-Sperre freigegeben wird.

AcquireReaderLock unterstützt rekursive Lese-/Lesesperranforderungen. Das heißt, ein Thread kann AcquireReaderLock mehrmals aufrufen, wodurch die Sperranzahl jedes Mal erhöht wird. Sie müssen jedes Mal einmal anrufen ReleaseReaderLock , wenn Sie anrufen AcquireReaderLock. Alternativ können Sie aufrufen ReleaseLock , um die Sperranzahl sofort auf Null zu reduzieren.

Rekursive Sperranforderungen werden immer sofort gewährt, ohne den anfordernden Thread in der Lesewarteschlange zu platzieren. Verwenden Sie rekursive Sperren mit Vorsicht, um das Blockieren von Schreibsperranforderungen für lange Zeiträume zu vermeiden.

Gültige Timeoutwerte finden Sie unter ReaderWriterLock.

Weitere Informationen

• Verwaltetes Thread-Management
• Readerwriterlock