ReaderWriterLock.AcquireWriterLock Método

  • Referência

Definição

Namespace:
System.Threading
Assembly:
System.Threading.dll
Assembly:
mscorlib.dll
Assembly:
netstandard.dll

Adquire o bloqueio de gravador.

Sobrecargas

AcquireWriterLock(Int32)

Adquire um bloqueio de gravador, usando um valor Int32 para o tempo limite.
AcquireWriterLock(TimeSpan)

Adquire um bloqueio de gravador, usando um valor TimeSpan para o tempo limite.

AcquireWriterLock(Int32)

Adquire um bloqueio de gravador, usando um valor Int32 para o tempo limite.

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

Parâmetros

millisecondsTimeout
Int32

O tempo limite em milissegundos.

Exceções

ApplicationException

O timeout expira antes que a solicitação de bloqueio seja concedida.

Exemplos

O exemplo de código a seguir mostra como adquirir e liberar um bloqueio de gravador e como lidar com a exceção gerada quando uma solicitação atinge o tempo limite.

Esse código faz parte de um exemplo maior fornecido para a ReaderWriterLock classe.

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

Comentários

Esse método bloqueia se outro thread tiver um bloqueio de leitor ou bloqueio de gravador. Para obter uma descrição da maneira como o bloqueio do gravador alterna com vários bloqueios de leitor simultâneos, consulte a ReaderWriterLock classe.

Um thread que já tem um bloqueio de leitor pode adquirir o bloqueio do gravador de uma das duas maneiras: liberando o bloqueio do leitor antes de chamar AcquireWriterLockou chamando UpgradeToWriterLock.

Cuidado

Se um thread for chamado AcquireWriterLock enquanto ainda tiver um bloqueio de leitor, ele será bloqueado em seu próprio bloqueio de leitor; se um tempo limite infinito for especificado, o thread ficará em deadlock. Para evitar esses deadlocks, use IsReaderLockHeld para determinar se o thread atual já tem um bloqueio de leitor.

AcquireWriterLock dá suporte a solicitações recursivas de bloqueio de gravador. Ou seja, um thread pode chamar AcquireWriterLock várias vezes, o que incrementa a contagem de bloqueios cada vez. Você deve ligar ReleaseWriterLock uma vez para cada vez que ligar AcquireWriterLock. Como alternativa, você pode chamar ReleaseLock para reduzir a contagem de bloqueios para zero imediatamente.

As solicitações de bloqueio recursivo sempre são concedidas imediatamente, sem colocar o thread de solicitação na fila do gravador.

Para obter valores de tempo limite válidos, consulte ReaderWriterLock.

Confira também

Aplica-se a

AcquireWriterLock(TimeSpan)

Adquire um bloqueio de gravador, usando um valor TimeSpan para o tempo limite.

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

Parâmetros

timeout
TimeSpan

O TimeSpan que especifica o período de tempo limite.

Exceções

ApplicationException

O timeout expira antes que a solicitação de bloqueio seja concedida.

ArgumentOutOfRangeException

timeout especifica um valor negativo diferente de -1 milissegundo.

Comentários

Esse método bloqueia se outro thread tiver um bloqueio de leitor ou bloqueio de gravador. Para obter uma descrição da maneira como o bloqueio do gravador alterna com vários bloqueios de leitor simultâneos, consulte a ReaderWriterLock classe.

Um thread que já tem um bloqueio de leitor pode adquirir o bloqueio do gravador de uma das duas maneiras: liberando o bloqueio do leitor antes de chamar AcquireWriterLockou chamando UpgradeToWriterLock.

Cuidado

Se um thread for chamado AcquireWriterLock enquanto ainda tiver um bloqueio de leitor, ele será bloqueado em seu próprio bloqueio de leitor; se um tempo limite infinito for especificado, o thread será deadlock. Para evitar esses deadlocks, use IsReaderLockHeld para determinar se o thread atual já tem um bloqueio de leitor.

AcquireWriterLock dá suporte a solicitações recursivas de bloqueio de gravador. Ou seja, um thread pode chamar AcquireWriterLock várias vezes, o que incrementa a contagem de bloqueios cada vez. Você deve ligar ReleaseWriterLock uma vez para cada vez que ligar AcquireWriterLock. Como alternativa, você pode chamar ReleaseLock para reduzir a contagem de bloqueios para zero imediatamente.

As solicitações de bloqueio recursivo sempre são concedidas imediatamente, sem colocar o thread de solicitação na fila do gravador.

Para obter valores de tempo limite válidos, consulte ReaderWriterLock.

Confira também

Aplica-se a