ReaderWriterLock.AcquireWriterLock Metoda

Definicja

Przestrzeń nazw:: System.Threading

Zestawy:: netstandard.dll, System.Threading.dll

Zestaw:: System.Threading.dll

Zestaw:: mscorlib.dll

Zestaw:: netstandard.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Uzyskuje blokadę modułu zapisywania.

Przeciążenia

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

AcquireWriterLock(Int32)

Źródło:: ReaderWriterLock.cs

Źródło:: ReaderWriterLock.cs

Źródło:: ReaderWriterLock.cs

Źródło:: ReaderWriterLock.cs

Źródło:: ReaderWriterLock.cs

Uzyskuje blokadę Int32 modułu zapisywania przy użyciu 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

millisecondsTimeout 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ł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 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ę zapisywania. Aby uzyskać opis sposobu, w jaki moduł zapisywania blokuje alternatywne elementy z wieloma równoczesnymi blokadami czytnika, 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 przez wywołanie metody UpgradeToWriterLock.

Caution

Jeśli wątek wywołuje AcquireWriterLock blokadę czytnika, zablokuje blokadę własnego czytnika. Jeśli zostanie określony nieskończony limit czasu, wątek zostanie zakleszony. 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 i blokowania. Oznacza to, że wątek może wywołać AcquireWriterLock wiele razy, co zwiększa liczbę blokad za każdym razem. Należy wywołać ReleaseWriterLock raz za każdym razem, gdy wywołasz metodę AcquireWriterLock. Alternatywnie możesz wywołać metodę ReleaseLock , aby natychmiast zmniejszyć liczbę blokad do zera.

Żądania cyklicznej blokady są zawsze przyznawane natychmiast, bez umieszczania wątku żądającego w kolejce modułu zapisywania.

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

Zobacz też

Dotyczy

AcquireWriterLock(TimeSpan)

Źródło:: ReaderWriterLock.cs

Źródło:: ReaderWriterLock.cs

Źródło:: ReaderWriterLock.cs

Źródło:: ReaderWriterLock.cs

Źródło:: ReaderWriterLock.cs

Uzyskuje blokadę TimeSpan modułu zapisywania przy użyciu 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 milisekund.