ReaderWriterLock.AcquireWriterLock Método

Definición

Espacio de nombres:

System.Threading

Ensamblado:

System.Threading.dll

Ensamblado:

mscorlib.dll

Ensamblado:

netstandard.dll

Adquiere el bloqueo de escritor.

Sobrecargas

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

AcquireWriterLock(Int32)

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

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

Tiempo de espera en milisegundos.

Excepciones

ApplicationException

timeout 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 escritor 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 the writer lock, and
// how to handle time-outs.
static void WriteToResource( Random^ rnd, int timeOut )
{
   try
   {
      rwl->AcquireWriterLock( timeOut );
      try
      {

         // It is safe for this thread to read or write
         // from the shared resource.
         resource = rnd->Next( 500 );
         Display( String::Format( "writes resource value {0}", resource ) );
         Interlocked::Increment( writes );
      }
      finally
      {

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

   }
   catch ( ApplicationException^ )
   {

      // The writer lock request timed out.
      Interlocked::Increment( writerTimeouts );
   }

}

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

Comentarios

Este método bloquea si otro subproceso tiene un bloqueo de lector o un bloqueo de escritor. Para obtener una descripción de la forma en que el bloqueo del escritor se alterna con varios bloqueos de lector simultáneos, consulte la ReaderWriterLock clase .

Un subproceso que ya tiene un bloqueo de lector puede adquirir el bloqueo del escritor de dos maneras: liberando el bloqueo del lector antes de llamar a AcquireWriterLocko llamando a UpgradeToWriterLock.

Precaución

Si un subproceso llama AcquireWriterLock mientras sigue teniendo un bloqueo de lector, se bloqueará en su propio bloqueo de lector; si se especifica un tiempo de espera infinito, el subproceso se interbloqueará. Para evitar estos interbloqueos, use IsReaderLockHeld para determinar si el subproceso actual ya tiene un bloqueo de lector.

AcquireWriterLock admite solicitudes recursivas de bloqueo de escritura. Es decir, un subproceso puede llamar varias AcquireWriterLock veces, lo que incrementa el recuento de bloqueos cada vez. Debe llamar ReleaseWriterLock una vez por cada vez que llame a AcquireWriterLock. 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 escritor.

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

Consulte también

• Subprocesamiento administrado
• ReaderWriterLock

AcquireWriterLock(TimeSpan)

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

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

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

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

Este método bloquea si otro subproceso tiene un bloqueo de lector o un bloqueo de escritor. Para obtener una descripción de la forma en que el bloqueo del escritor se alterna con varios bloqueos de lector simultáneos, consulte la ReaderWriterLock clase .

Un subproceso que ya tiene un bloqueo de lector puede adquirir el bloqueo del escritor de dos maneras: liberando el bloqueo del lector antes de llamar a AcquireWriterLocko llamando a UpgradeToWriterLock.

Precaución

Si un subproceso llama AcquireWriterLock mientras sigue teniendo un bloqueo de lector, se bloqueará en su propio bloqueo de lector; si se especifica un tiempo de espera infinito, el subproceso se interbloqueará. Para evitar estos interbloqueos, use IsReaderLockHeld para determinar si el subproceso actual ya tiene un bloqueo de lector.

AcquireWriterLock admite solicitudes recursivas de bloqueo de escritura. Es decir, un subproceso puede llamar varias AcquireWriterLock veces, lo que incrementa el recuento de bloqueos cada vez. Debe llamar ReleaseWriterLock una vez por cada vez que llame a AcquireWriterLock. 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 escritor.

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

Consulte también

• Subprocesamiento administrado
• ReaderWriterLock