ReaderWriterLock.AcquireWriterLock Método

Definição

Adquire o bloqueio do gravador.

Sobrecargas

Nome Description
AcquireWriterLock(Int32)

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

AcquireWriterLock(TimeSpan)

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

AcquireWriterLock(Int32)

Origem:
ReaderWriterLock.cs
Origem:
ReaderWriterLock.cs
Origem:
ReaderWriterLock.cs
Origem:
ReaderWriterLock.cs
Origem:
ReaderWriterLock.cs

Adquire o bloqueio de gravador usando um Int32 valor 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

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

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 duas maneiras: liberando o bloqueio do leitor antes de chamar AcquireWriterLockou chamando UpgradeToWriterLock.

Caution

Se um thread chamar AcquireWriterLock enquanto ainda tiver um bloqueio de leitor, ele bloqueará em seu próprio bloqueio de leitor; se um tempo limite infinito for especificado, o thread será bloqueado. Para evitar tais 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 a 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.

Solicitações de bloqueio recursivo são sempre 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)

Origem:
ReaderWriterLock.cs
Origem:
ReaderWriterLock.cs
Origem:
ReaderWriterLock.cs
Origem:
ReaderWriterLock.cs
Origem:
ReaderWriterLock.cs

Adquire o bloqueio de gravador usando um TimeSpan valor 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

A TimeSpan especificação do período de tempo limite.

Exceções

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

timeout especifica um valor negativo diferente de -1 milissegundos.

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 duas maneiras: liberando o bloqueio do leitor antes de chamar AcquireWriterLockou chamando UpgradeToWriterLock.

Caution

Se um thread chamar AcquireWriterLock enquanto ainda tiver um bloqueio de leitor, ele bloqueará em seu próprio bloqueio de leitor; se um tempo limite infinito for especificado, o thread será bloqueado. Para evitar tais 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 a 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.

Solicitações de bloqueio recursivo são sempre 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