Compartir a través de

ReaderWriterLock.AcquireReaderLock Método

  • Referencia

Definición

Espacio de nombres:
System.Threading
Ensamblado:
System.Threading.dll
Ensamblado:
mscorlib.dll
Ensamblado:
netstandard.dll

Adquiere un bloqueo de lector.

Sobrecargas

AcquireReaderLock(Int32)

Adquiere un bloqueo de lector, utilizando un valor Int32 para el tiempo de espera.
AcquireReaderLock(TimeSpan)

Adquiere un bloqueo de lector, utilizando un valor TimeSpan para el tiempo de espera.

AcquireReaderLock(Int32)

Adquiere un bloqueo de lector, utilizando un valor Int32 para el tiempo de espera.

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

Tiempo de espera en milisegundos.

Atributos
UnsupportedOSPlatformAttribute

Excepciones

ApplicationException

millisecondsTimeout expira antes de que se conceda la solicitud de bloqueo.

Ejemplos

En el ejemplo de código siguiente se muestra cómo adquirir y liberar un bloqueo de lector y cómo controlar la excepción iniciada cuando se agota el tiempo de espera de una solicitud.

Este código forma parte de un ejemplo más grande proporcionado para la ReaderWriterLock clase .

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

Comentarios

AcquireReaderLock bloquea si un subproceso diferente tiene el bloqueo del escritor o si al menos un subproceso está esperando el bloqueo del escritor.

Nota

Si el subproceso actual ya tiene el bloqueo del escritor, no se adquiere ningún bloqueo de lector. En su lugar, se incrementa el recuento de bloqueos en el bloqueo del escritor. Esto evita que un subproceso bloquee su propio bloqueo de escritura. El resultado es exactamente el mismo que llamar AcquireWriterLocka y se requiere una llamada adicional a ReleaseWriterLock al liberar el bloqueo del escritor.

AcquireReaderLock admite solicitudes recursivas de bloqueo de lector. Es decir, un subproceso puede llamar a AcquireReaderLock varias veces, lo que incrementa el recuento de bloqueos cada vez. Debe llamar ReleaseReaderLock una vez por cada vez que llame a AcquireReaderLock. Como alternativa, puede llamar ReleaseLock a para reducir el número de bloqueos a cero inmediatamente.

Las solicitudes de bloqueo recursiva siempre se conceden inmediatamente, sin colocar el subproceso solicitante en la cola del lector. Use bloqueos recursivos con precaución para evitar bloquear las solicitudes de bloqueo del sistema de escritura durante largos períodos.

Para conocer los valores de tiempo de espera válidos, consulte ReaderWriterLock.

Consulte también

Se aplica a

AcquireReaderLock(TimeSpan)

Adquiere un bloqueo de lector, utilizando un valor TimeSpan para el tiempo de espera.

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

Un TimeSpan que especifica el período de duración del tiempo de espera.

Atributos
UnsupportedOSPlatformAttribute

Excepciones

ApplicationException

timeout expira antes de que se conceda la solicitud de bloqueo.

ArgumentOutOfRangeException

timeout especifica un valor negativo que no es -1 milisegundos.

Comentarios

AcquireReaderLock bloquea si un subproceso diferente tiene el bloqueo del escritor o si al menos un subproceso está esperando el bloqueo del escritor.

Nota

Si el subproceso actual ya tiene el bloqueo del escritor, no se adquiere ningún bloqueo de lector. En su lugar, se incrementa el recuento de bloqueos en el bloqueo del escritor. Esto evita que un subproceso bloquee su propio bloqueo de escritura. El resultado es exactamente el mismo que llamar AcquireWriterLocka y se requiere una llamada adicional a ReleaseWriterLock al liberar el bloqueo del escritor.

AcquireReaderLock admite solicitudes recursivas de bloqueo de lector. Es decir, un subproceso puede llamar a AcquireReaderLock varias veces, lo que incrementa el recuento de bloqueos cada vez. Debe llamar ReleaseReaderLock una vez por cada vez que llame a AcquireReaderLock. Como alternativa, puede llamar ReleaseLock a para reducir el número de bloqueos a cero inmediatamente.

Las solicitudes de bloqueo recursiva siempre se conceden inmediatamente, sin colocar el subproceso solicitante en la cola del lector. Use bloqueos recursivos con precaución para evitar bloquear las solicitudes de bloqueo del sistema de escritura durante largos períodos.

Para conocer los valores de tiempo de espera válidos, consulte ReaderWriterLock.

Consulte también

Se aplica a