ReaderWriterLock.AcquireReaderLock Método

Definição

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

Adquire um bloqueio de leitor.

Sobrecargas

Nome Description
AcquireReaderLock(Int32)

Adquire um bloqueio de leitor usando um Int32 valor para o tempo limite.
AcquireReaderLock(TimeSpan)

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

AcquireReaderLock(Int32)

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

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

public:
 void AcquireReaderLock(int millisecondsTimeout);
[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public void AcquireReaderLock(int millisecondsTimeout);
public void AcquireReaderLock(int millisecondsTimeout);
[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
member this.AcquireReaderLock : int -> unit
member this.AcquireReaderLock : int -> unit
Public Sub AcquireReaderLock (millisecondsTimeout As Integer)

Parâmetros

millisecondsTimeout
Int32

O tempo limite em milissegundos.

Atributos
UnsupportedOSPlatformAttribute

Exceções

ApplicationException

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

Comentários

AcquireReaderLock bloqueia se um thread diferente tiver o bloqueio de gravador ou se pelo menos um thread estiver aguardando o bloqueio do gravador.

Note

Se o thread atual já tiver o bloqueio de gravador, nenhum bloqueio de leitor será adquirido. Em vez disso, a contagem de bloqueios no bloqueio do gravador é incrementada. Isso impede que um thread bloqueie seu próprio bloqueio de gravador. O resultado é exatamente o mesmo que chamar AcquireWriterLocke uma chamada adicional é necessária ao ReleaseWriterLock liberar o bloqueio do gravador.

AcquireReaderLock dá suporte a solicitações recursivas de bloqueio de leitor. Ou seja, um thread pode chamar AcquireReaderLock várias vezes, o que incrementa a contagem de bloqueios a cada vez. Você deve ligar ReleaseReaderLock uma vez para cada vez que ligar AcquireReaderLock. 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 leitor. Use bloqueios recursivos com cuidado para evitar o bloqueio de solicitações de bloqueio de gravador por longos períodos.

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

Confira também

Aplica-se a

AcquireReaderLock(TimeSpan)

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

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

public:
 void AcquireReaderLock(TimeSpan timeout);
[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public void AcquireReaderLock(TimeSpan timeout);
public void AcquireReaderLock(TimeSpan timeout);
[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
member this.AcquireReaderLock : TimeSpan -> unit
member this.AcquireReaderLock : TimeSpan -> unit
Public Sub AcquireReaderLock (timeout As TimeSpan)

Parâmetros

timeout
TimeSpan

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

Atributos
UnsupportedOSPlatformAttribute

Exceções

ApplicationException

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

ArgumentOutOfRangeException

timeout especifica um valor negativo diferente de -1 milissegundos.

Comentários

AcquireReaderLock bloqueia se um thread diferente tiver o bloqueio de gravador ou se pelo menos um thread estiver aguardando o bloqueio do gravador.

Note

Se o thread atual já tiver o bloqueio de gravador, nenhum bloqueio de leitor será adquirido. Em vez disso, a contagem de bloqueios no bloqueio do gravador é incrementada. Isso impede que um thread bloqueie seu próprio bloqueio de gravador. O resultado é exatamente o mesmo que chamar AcquireWriterLocke uma chamada adicional é necessária ao ReleaseWriterLock liberar o bloqueio do gravador.

AcquireReaderLock dá suporte a solicitações recursivas de bloqueio de leitor. Ou seja, um thread pode chamar AcquireReaderLock várias vezes, o que incrementa a contagem de bloqueios a cada vez. Você deve ligar ReleaseReaderLock uma vez para cada vez que ligar AcquireReaderLock. 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 leitor. Use bloqueios recursivos com cuidado para evitar o bloqueio de solicitações de bloqueio de gravador por longos períodos.

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

Confira também

Aplica-se a