ReaderWriterLock.AcquireReaderLock Metoda

Definicja

Przestrzeń nazw:

System.Threading

Zestaw:

System.Threading.dll

Uzyskuje blokadę czytnika.

Przeciążenia

AcquireReaderLock(Int32)	Uzyskuje blokadę czytnika przy użyciu Int32 wartości limitu czasu.
AcquireReaderLock(TimeSpan)	Uzyskuje blokadę czytnika przy użyciu TimeSpan 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

W poniższym przykładzie kodu pokazano, jak uzyskać i zwolnić blokadę czytnika oraz jak obsłużyć wyjątek zgłaszany po przekroczeniu limitu 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 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

Uwagi

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

Uwaga

Jeśli bieżący wątek ma już blokadę modułu zapisywania, nie zostanie pozyskana żadna blokada czytnika. Zamiast tego liczba blokad na 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 czytników. Oznacza to, że wątek może wywołać funkcję AcquireReaderLock wiele razy, co zwiększa liczbę blokad za każdym razem. Musisz zadzwonić ReleaseReaderLock raz za każdym razem, gdy wywołasz metodę AcquireReaderLock. Alternatywnie można wywołać metodę ReleaseLock w celu natychmiastowego zmniejszenia liczby blokad do zera.

Żądania cyklicznego blokowania są zawsze przyznawane natychmiast, bez umieszczania żądanego wątku w kolejce czytnika. Używaj cyklicznych 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ątki
• Readerwriterlock

AcquireReaderLock(TimeSpan)

Źródło:

ReaderWriterLock.cs

Uzyskuje blokadę czytnika przy użyciu TimeSpan 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 milisekundy.

Uwagi

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

Uwaga

Jeśli bieżący wątek ma już blokadę modułu zapisywania, nie zostanie pozyskana żadna blokada czytnika. Zamiast tego liczba blokad na 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 czytników. Oznacza to, że wątek może wywołać funkcję AcquireReaderLock wiele razy, co zwiększa liczbę blokad za każdym razem. Musisz zadzwonić ReleaseReaderLock raz za każdym razem, gdy wywołasz metodę AcquireReaderLock. Alternatywnie można wywołać metodę ReleaseLock w celu natychmiastowego zmniejszenia liczby blokad do zera.

Żądania cyklicznego blokowania są zawsze przyznawane natychmiast, bez umieszczania żądanego wątku w kolejce czytnika. Używaj cyklicznych 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ątki
• Readerwriterlock