Udostępnij za pośrednictwem

ReaderWriterLock.AcquireWriterLock Metoda

  • Odwołanie

Definicja

Przestrzeń nazw:
System.Threading
Zestaw:
System.Threading.dll
Zestaw:
mscorlib.dll
Zestaw:
netstandard.dll

Uzyskuje blokadę modułu zapisywania.

Przeciążenia

AcquireWriterLock(Int32)

Uzyskuje blokadę modułu zapisywania przy użyciu Int32 wartości limitu czasu.
AcquireWriterLock(TimeSpan)

Uzyskuje blokadę modułu zapisywania przy użyciu TimeSpan wartości limitu czasu.

AcquireWriterLock(Int32)

Uzyskuje blokadę modułu zapisywania przy użyciu Int32 wartości limitu czasu.

public:
 void AcquireWriterLock(int millisecondsTimeout);
public void AcquireWriterLock (int millisecondsTimeout);
member this.AcquireWriterLock : int -> unit
Public Sub AcquireWriterLock (millisecondsTimeout As Integer)

Parametry

millisecondsTimeout
Int32

Limit czasu w milisekundach.

Wyjątki

ApplicationException

timeout wygasa przed udzieleniem żądania blokady.

Przykłady

W poniższym przykładzie kodu pokazano, jak uzyskać i zwolnić blokadę modułu zapisywania oraz jak obsłużyć wyjątek zgłaszany w przypadku przekroczenia 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 the writer lock, and
// how to handle time-outs.
static void WriteToResource( Random^ rnd, int timeOut )
{
   try
   {
      rwl->AcquireWriterLock( timeOut );
      try
      {

         // It is safe for this thread to read or write
         // from the shared resource.
         resource = rnd->Next( 500 );
         Display( String::Format( "writes resource value {0}", resource ) );
         Interlocked::Increment( writes );
      }
      finally
      {

         // Ensure that the lock is released.
         rwl->ReleaseWriterLock();
      }

   }
   catch ( ApplicationException^ )
   {

      // The writer lock request timed out.
      Interlocked::Increment( writerTimeouts );
   }

}

// Request and release the writer lock, and handle time-outs.
static void WriteToResource(Random rnd, int timeOut)
{
   try {
      rwl.AcquireWriterLock(timeOut);
      try {
         // It's safe for this thread to access from the shared resource.
         resource = rnd.Next(500);
         Display("writes resource value " + resource);
         Interlocked.Increment(ref writes);
      }
      finally {
         // Ensure that the lock is released.
         rwl.ReleaseWriterLock();
      }
   }
   catch (ApplicationException) {
      // The writer lock request timed out.
      Interlocked.Increment(ref writerTimeouts);
   }
}

' Request and release the writer lock, and handle time-outs.
Sub WriteToResource(rnd As Random, timeOut As Integer)
   Try
      rwl.AcquireWriterLock(timeOut)
      Try
         ' It's safe for this thread to read or write from the shared resource.
         resource = rnd.Next(500)
         Display("writes resource value " & resource)
         Interlocked.Increment(writes)
      Finally
         ' Ensure that the lock is released.
         rwl.ReleaseWriterLock()
      End Try
   Catch ex As ApplicationException
      ' The writer lock request timed out.
      Interlocked.Increment(writerTimeouts)
   End Try
End Sub

};

}

End Module

Uwagi

Ta metoda blokuje, jeśli inny wątek ma blokadę czytnika lub blokadę modułu zapisywania. Aby uzyskać opis sposobu blokowania przez moduł zapisywania alternatywnych z wieloma blokadami czytnika współbieżnego, zobacz klasę ReaderWriterLock .

Wątek, który ma już blokadę czytnika, może uzyskać blokadę modułu zapisywania na jeden z dwóch sposobów: zwalniając blokadę czytnika przed wywołaniem AcquireWriterLockmetody lub wywołując UpgradeToWriterLockpolecenie .

Przestroga

Jeśli wątek wywołuje AcquireWriterLock blokadę czytnika, zablokuje blokadę czytnika. Jeśli zostanie określony nieskończony limit czasu, wątek będzie zakleszać. Aby uniknąć takich zakleszczeń, użyj polecenia IsReaderLockHeld , aby określić, czy bieżący wątek ma już blokadę czytnika.

AcquireWriterLock obsługuje cykliczne żądania zapisywania blokady. Oznacza to, że wątek może wywoływać AcquireWriterLock wiele razy, co zwiększa liczbę blokad za każdym razem. Musisz zadzwonić ReleaseWriterLock raz za każdym razem, gdy wywołasz metodę AcquireWriterLock. 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 modułu zapisywania.

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

Zobacz też

Dotyczy

AcquireWriterLock(TimeSpan)

Uzyskuje blokadę modułu zapisywania przy użyciu TimeSpan wartości limitu czasu.

public:
 void AcquireWriterLock(TimeSpan timeout);
public void AcquireWriterLock (TimeSpan timeout);
member this.AcquireWriterLock : TimeSpan -> unit
Public Sub AcquireWriterLock (timeout As TimeSpan)

Parametry

timeout
TimeSpan

Określanie TimeSpan limitu czasu.

Wyjątki

ApplicationException

timeout wygasa przed udzieleniem żądania blokady.

ArgumentOutOfRangeException

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

Uwagi

Ta metoda blokuje, jeśli inny wątek ma blokadę czytnika lub blokadę modułu zapisywania. Aby uzyskać opis sposobu blokowania przez moduł zapisywania alternatywnych z wieloma blokadami czytnika współbieżnego, zobacz klasę ReaderWriterLock .

Wątek, który ma już blokadę czytnika, może uzyskać blokadę modułu zapisywania na jeden z dwóch sposobów: zwalniając blokadę czytnika przed wywołaniem AcquireWriterLockmetody lub wywołując UpgradeToWriterLockpolecenie .

Przestroga

Jeśli wątek wywołuje AcquireWriterLock blokadę czytnika, zablokuje blokadę czytnika. Jeśli zostanie określony nieskończony limit czasu, wątek będzie zakleszać. Aby uniknąć takich zakleszczeń, użyj polecenia IsReaderLockHeld , aby określić, czy bieżący wątek ma już blokadę czytnika.

AcquireWriterLock obsługuje cykliczne żądania zapisywania blokady. Oznacza to, że wątek może wywoływać AcquireWriterLock wiele razy, co zwiększa liczbę blokad za każdym razem. Musisz zadzwonić ReleaseWriterLock raz za każdym razem, gdy wywołasz metodę AcquireWriterLock. 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 modułu zapisywania.

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

Zobacz też

Dotyczy