ReaderWriterLock.AcquireReaderLock 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 um bloqueio de leitor.

Sobrecargas

Name	Description
AcquireReaderLock(Int32)	Adquire um bloqueio de leitor, usando um Int32 valor para o time-out.
AcquireReaderLock(TimeSpan)	Adquire um bloqueio de leitor, usando um TimeSpan valor para o time-out.

AcquireReaderLock(Int32)

Adquire um bloqueio de leitor, usando um Int32 valor para o time-out.

public:
 void AcquireReaderLock(int millisecondsTimeout);

public void AcquireReaderLock(int millisecondsTimeout);

member this.AcquireReaderLock : int -> unit

Public Sub AcquireReaderLock (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 leitor, 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 a reader lock, and handle time-outs.
static void ReadFromResource(int timeOut)
{
   try {
      rwl.AcquireReaderLock(timeOut);
      try {
         // It is safe for this thread to read from the shared resource.
         Display("reads resource value " + resource);
         Interlocked.Increment(ref reads);
      }
      finally {
         // Ensure that the lock is released.
         rwl.ReleaseReaderLock();
      }
   }
   catch (ApplicationException) {
      // The reader lock request timed out.
      Interlocked.Increment(ref readerTimeouts);
   }
}

' Request and release a reader lock, and handle time-outs.
Sub ReadFromResource(timeOut As Integer)
   Try
      rwl.AcquireReaderLock(timeOut)
      Try
         ' It's safe for this thread to read from the shared resource.
         Display("reads resource value " & resource)
         Interlocked.Increment(reads)
      Finally
         ' Ensure that the lock is released.
         rwl.ReleaseReaderLock()
      End Try
   Catch ex As ApplicationException
      ' The reader lock request timed out.
      Interlocked.Increment(readerTimeouts)
   End Try
End Sub

End Module

Observações

AcquireReaderLock bloqueia se outro tópico tiver o bloqueio do escritor, ou se pelo menos um fio estiver à espera do bloqueio do escritor.

Note

Se o tópico atual já tiver o bloqueio do escritor, não é adquirido nenhum bloqueio do leitor. Em vez disso, a contagem de bloqueios no bloqueio escritor é incrementada. Isto impede que um thread bloqueie no seu próprio bloqueio de escritor. O resultado é exatamente o mesmo que ao chamar AcquireWriterLock, e é necessário um chamado adicional ao ReleaseWriterLock libertar o bloqueio do escritor.

AcquireReaderLock suporta pedidos recursivos de bloqueio de leitor. Ou seja, um thread pode chamar o AcquireReaderLock várias vezes, o que incrementa a contagem de bloqueios a cada vez. Deve ligar ReleaseReaderLock uma vez por cada vez que ligar AcquireReaderLock. 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 do pedido na fila do leitor. Use bloqueios recursivos com cautela, para evitar bloquear pedidos de bloqueio de escritor durante longos períodos.

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

Ver também

de threading gerenciado
ReaderWriterLock

Aplica-se a

AcquireReaderLock(TimeSpan)

Adquire um bloqueio de leitor, usando um TimeSpan valor para o time-out.

public:
 void AcquireReaderLock(TimeSpan timeout);

public void AcquireReaderLock(TimeSpan timeout);

member this.AcquireReaderLock : TimeSpan -> unit

Public Sub AcquireReaderLock (timeout As TimeSpan)

Parâmetros

timeout: TimeSpan

A TimeSpan especificar o 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.