ReaderWriterLock.AcquireWriterLock Método

Definição

Espaço de Nomes:: System.Threading

Assemblagem:: mscorlib.dll

Assemblagem:: netstandard.dll

Importante

Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.

Adquire o bloqueio do escritor.

Sobrecargas

Name	Description
AcquireWriterLock(Int32)	Obtém o bloqueio do escritor, usando um Int32 valor para o time-out.
AcquireWriterLock(TimeSpan)	Obtém o bloqueio do escritor, usando um TimeSpan valor para o time-out.

AcquireWriterLock(Int32)

Obtém o bloqueio do escritor, usando um Int32 valor para o time-out.

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 em milissegundos.

Exceções

ApplicationException

millisecondsTimeout expira antes de o pedido de bloqueio ser concedido.

Exemplos

O exemplo de código seguinte mostra como adquirir e libertar um bloqueio de escritor, e como lidar com a exceção lançada quando um pedido expira.

Este código faz parte de um exemplo mais amplo fornecido para a ReaderWriterLock turma.

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

Observações

Este método bloqueia se outro tópico tiver um bloqueio de leitor ou de escritor. Para uma descrição da forma como o bloqueio do escritor alterna com múltiplos bloqueios de leitor simultâneos, veja a ReaderWriterLock classe.

Um fio que já tem um bloqueio de leitor pode adquirir o bloqueio de escritor de duas formas: libertando o bloqueio de leitor antes de chamar AcquireWriterLock, ou chamando UpgradeToWriterLock.

Atenção

Se um thread chamar AcquireWriterLock enquanto ainda tem bloqueio de leitor, irá bloquear no seu próprio bloqueio de leitor; se for especificado um time-out infinito, o thread ficará bloqueado. Para evitar tais bloqueios, use IsReaderLockHeld para determinar se o thread atual já tem um bloqueio de leitor.

AcquireWriterLock suporta pedidos recursivos de bloqueio de escritor. Ou seja, um thread pode chamar AcquireWriterLock várias vezes, o que incrementa o número de bloqueios a cada vez. Deve ligar ReleaseWriterLock uma vez por cada vez que ligar AcquireWriterLock. Alternativamente, podes ligar ReleaseLock para reduzir imediatamente o número de bloqueios a zero.

Os pedidos de bloqueio recursivo são sempre concedidos imediatamente, sem colocar o fio de pedido na fila de escritor.

Para valores válidos de time-out, veja ReaderWriterLock.

Ver também

de threading gerenciado
ReaderWriterLock

Aplica-se a

AcquireWriterLock(TimeSpan)

Obtém o bloqueio do escritor, usando um TimeSpan valor para o time-out.

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 time-out.

Exceções

ApplicationException

timeout expira antes de o pedido de bloqueio ser concedido.

ArgumentOutOfRangeException

timeout especifica um valor negativo diferente de -1 milissegundos.