ReaderWriterLock.AcquireReaderLock Metoda

Definicja

Przestrzeń nazw:

System.Threading

Zestawy:

netstandard.dll, System.Threading.dll

Uzyskuje blokadę czytnika.

Przeciążenia

Nazwa	Opis
AcquireReaderLock(Int32)	Uzyskuje blokadę czytnika przy użyciu Int32 wartości limitu czasu.
AcquireReaderLock(TimeSpan)	Uzyskuje blokadę TimeSpan czytnika przy użyciu wartości limitu czasu.

AcquireReaderLock(Int32)

Źródło:

ReaderWriterLock.cs

Uzyskuje blokadę czytnika przy użyciu Int32 wartości limitu czasu.

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)

Parametry

millisecondsTimeout

Int32

Limit czasu w milisekundach.

Atrybuty

UnsupportedOSPlatformAttribute

Wyjątki

ApplicationException

millisecondsTimeout wygasa przed udzieleniem żądania blokady.

Przykłady

Poniższy przykład kodu pokazuje, jak uzyskać i zwolnić blokadę czytnika oraz jak obsługiwać wyjątek zgłaszany po upłynął limit czasu żądania.

Ten kod jest częścią większego przykładu udostępnionego ReaderWriterLock dla klasy .

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

Uwagi

AcquireReaderLock bloki, jeśli inny wątek ma blokadę modułu zapisywania lub jeśli co najmniej jeden wątek czeka na blokadę modułu zapisywania.

Uwaga / Notatka

Jeśli bieżący wątek ma już blokadę modułu zapisywania, nie jest uzyskiwana żadna blokada czytnika. Zamiast tego liczba blokad w blokadzie modułu zapisywania jest zwiększana. Zapobiega to zablokowaniu wątku na własnej blokadzie modułu zapisywania. Wynik jest dokładnie taki sam jak wywołanie AcquireWriterLockmetody , a dodatkowe wywołanie ReleaseWriterLock jest wymagane podczas zwalniania blokady modułu zapisywania.

AcquireReaderLock obsługuje cykliczne żądania blokowania czytnika. Oznacza to, że wątek może wywołać funkcję AcquireReaderLock wiele razy, co zwiększa liczbę blokad za każdym razem. Należy wywołać ReleaseReaderLock raz za każdym razem, gdy wywołasz metodę AcquireReaderLock. Alternatywnie możesz wywołać metodę ReleaseLock , aby natychmiast zmniejszyć liczbę blokad do zera.

Żądania cyklicznego blokowania są zawsze przyznawane natychmiast, bez umieszczania wątek żądania w kolejce czytnika. Używaj rekursywnych blokad z ostrożnością, aby uniknąć blokowania żądań zapisywania blokady przez długi czas.

Aby uzyskać prawidłowe wartości limitu czasu, zobacz ReaderWriterLock.

Zobacz też

• Zarządzane wątkowanie
• Readerwriterlock

AcquireReaderLock(TimeSpan)

Źródło:

ReaderWriterLock.cs

Uzyskuje blokadę TimeSpan czytnika przy użyciu wartości limitu czasu.

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)

Parametry

timeout

TimeSpan

Określenie TimeSpan limitu czasu.

Atrybuty

UnsupportedOSPlatformAttribute

Wyjątki

ApplicationException

timeout wygasa przed udzieleniem żądania blokady.

ArgumentOutOfRangeException

timeout określa wartość ujemną inną niż -1 milisekund.

Uwagi

AcquireReaderLock bloki, jeśli inny wątek ma blokadę modułu zapisywania lub jeśli co najmniej jeden wątek czeka na blokadę modułu zapisywania.

Uwaga / Notatka

Jeśli bieżący wątek ma już blokadę modułu zapisywania, nie jest uzyskiwana żadna blokada czytnika. Zamiast tego liczba blokad w blokadzie modułu zapisywania jest zwiększana. Zapobiega to zablokowaniu wątku na własnej blokadzie modułu zapisywania. Wynik jest dokładnie taki sam jak wywołanie AcquireWriterLockmetody , a dodatkowe wywołanie ReleaseWriterLock jest wymagane podczas zwalniania blokady modułu zapisywania.

AcquireReaderLock obsługuje cykliczne żądania blokowania czytnika. Oznacza to, że wątek może wywołać funkcję AcquireReaderLock wiele razy, co zwiększa liczbę blokad za każdym razem. Należy wywołać ReleaseReaderLock raz za każdym razem, gdy wywołasz metodę AcquireReaderLock. Alternatywnie możesz wywołać metodę ReleaseLock , aby natychmiast zmniejszyć liczbę blokad do zera.

Żądania cyklicznego blokowania są zawsze przyznawane natychmiast, bez umieszczania wątek żądania w kolejce czytnika. Używaj rekursywnych blokad z ostrożnością, aby uniknąć blokowania żądań zapisywania blokady przez długi czas.

Aby uzyskać prawidłowe wartości limitu czasu, zobacz ReaderWriterLock.

Zobacz też

• Zarządzane wątkowanie
• Readerwriterlock