Compartilhar via


ReaderWriterLock.AcquireReaderLock Método

Definição

Adquire um bloqueio de leitor.

Sobrecargas

AcquireReaderLock(Int32)

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

AcquireReaderLock(TimeSpan)

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

AcquireReaderLock(Int32)

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

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

Parâmetros

millisecondsTimeout
Int32

O tempo limite em milissegundos.

Atributos

Exceções

O 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 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 a reader lock, and
// how to 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( String::Format( "reads resource value {0}", resource ) );
         Interlocked::Increment( reads );
      }
      finally
      {

         // Ensure that the lock is released.
         rwl->ReleaseReaderLock();
      }

   }
   catch ( ApplicationException^ )
   {

      // The reader lock request timed out.
      Interlocked::Increment( readerTimeouts );
   }

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

Observação

Se o thread atual já tiver o bloqueio de gravador, nenhum bloqueio de leitor será adquirido. Em vez disso, a contagem de bloqueio no bloqueio do gravador é incrementada. Isso impede que um thread bloqueie em 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 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 sempre são concedidas imediatamente, sem colocar o thread de solicitação na fila do leitor. Use bloqueios recursivos com cuidado, para evitar bloquear solicitações de bloqueio de gravador por longos períodos.

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

Confira também

Aplica-se a

AcquireReaderLock(TimeSpan)

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

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

Parâmetros

timeout
TimeSpan

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

Atributos

Exceções

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

timeout especifica um valor negativo diferente de -1 milissegundo.

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.

Observação

Se o thread atual já tiver o bloqueio de gravador, nenhum bloqueio de leitor será adquirido. Em vez disso, a contagem de bloqueio no bloqueio do gravador é incrementada. Isso impede que um thread bloqueie em 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 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 sempre são concedidas imediatamente, sem colocar o thread de solicitação na fila do leitor. Use bloqueios recursivos com cuidado, para evitar bloquear solicitações de bloqueio de gravador por longos períodos.

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

Confira também

Aplica-se a