ReaderWriterLock.AcquireWriterLock Méthode

Définition

Espace de noms:

System.Threading

Assembly:

System.Threading.dll

Acquiert le verrou de writer.

Surcharges

AcquireWriterLock(Int32)	Acquiert un verrou de writer en utilisant une valeur Int32 comme délai d'attente.
AcquireWriterLock(TimeSpan)	Acquiert un verrou de writer en utilisant une valeur TimeSpan comme délai d'attente.

AcquireWriterLock(Int32)

Source:

ReaderWriterLock.cs

Acquiert un verrou de writer en utilisant une valeur Int32 comme délai d'attente.

public:
 void AcquireWriterLock(int millisecondsTimeout);

public void AcquireWriterLock (int millisecondsTimeout);

member this.AcquireWriterLock : int -> unit

Public Sub AcquireWriterLock (millisecondsTimeout As Integer)

Paramètres

millisecondsTimeout

Int32

Délai en millisecondes.

Exceptions

ApplicationException

timeout expire avant que la demande de verrou soit accordée.

Exemples

L’exemple de code suivant montre comment acquérir et libérer un verrou d’enregistreur et comment gérer l’exception levée lorsqu’une requête expire.

Ce code fait partie d’un exemple plus large fourni pour la 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 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

Remarques

Cette méthode bloque si un autre thread a un verrou de lecteur ou un verrou d’enregistreur. Pour obtenir une description de la façon dont le verrou de l’enregistreur alterne avec plusieurs verrous de lecteur simultanés, consultez la ReaderWriterLock classe .

Un thread qui a déjà un verrou de lecteur peut acquérir le verrou de l’enregistreur de deux manières : en libérant le verrou de lecteur avant d’appeler AcquireWriterLockou en appelant UpgradeToWriterLock.

Attention

Si un thread appelle AcquireWriterLock alors qu’il dispose toujours d’un verrou de lecteur, il se bloque sur son propre verrou de lecteur ; si un délai d’attente infini est spécifié, le thread se bloque. Pour éviter de tels interblocages, utilisez IsReaderLockHeld pour déterminer si le thread actuel a déjà un verrou de lecteur.

AcquireWriterLock prend en charge les demandes de verrouillage d’écriture récursives. Autrement dit, un thread peut appeler AcquireWriterLock plusieurs fois, ce qui incrémente le nombre de verrous à chaque fois. Vous devez appeler ReleaseWriterLock une seule fois pour chaque appel AcquireWriterLock. Vous pouvez également appeler ReleaseLock pour réduire immédiatement le nombre de verrous à zéro.

Les demandes de verrouillage récursives sont toujours accordées immédiatement, sans placer le thread demandeur dans la file d’attente de l’enregistreur.

Pour obtenir des valeurs de délai d’attente valides, consultez ReaderWriterLock.

Voir aussi

• Threading managé
• ReaderWriterLock

AcquireWriterLock(TimeSpan)

Source:

ReaderWriterLock.cs

Acquiert un verrou de writer en utilisant une valeur TimeSpan comme délai d'attente.

public:
 void AcquireWriterLock(TimeSpan timeout);

public void AcquireWriterLock (TimeSpan timeout);

member this.AcquireWriterLock : TimeSpan -> unit

Public Sub AcquireWriterLock (timeout As TimeSpan)

Paramètres

timeout

TimeSpan

TimeSpan spécifiant la durée du délai d'attente.

Exceptions

ApplicationException

timeout expire avant que la demande de verrou soit accordée.

ArgumentOutOfRangeException

timeout spécifie une valeur négative autre que -1 milliseconde.

Remarques

Cette méthode bloque si un autre thread a un verrou de lecteur ou un verrou d’enregistreur. Pour obtenir une description de la façon dont le verrou de l’enregistreur alterne avec plusieurs verrous de lecteur simultanés, consultez la ReaderWriterLock classe .

Un thread qui a déjà un verrou de lecteur peut acquérir le verrou de l’enregistreur de deux manières : en libérant le verrou de lecteur avant d’appeler AcquireWriterLockou en appelant UpgradeToWriterLock.

Attention

Si un thread appelle AcquireWriterLock alors qu’il dispose toujours d’un verrou de lecteur, il se bloque sur son propre verrou de lecteur ; si un délai d’attente infini est spécifié, le thread se bloque. Pour éviter de tels interblocages, utilisez IsReaderLockHeld pour déterminer si le thread actuel a déjà un verrou de lecteur.

AcquireWriterLock prend en charge les demandes de verrouillage d’écriture récursives. Autrement dit, un thread peut appeler AcquireWriterLock plusieurs fois, ce qui incrémente le nombre de verrous à chaque fois. Vous devez appeler ReleaseWriterLock une seule fois pour chaque appel AcquireWriterLock. Vous pouvez également appeler ReleaseLock pour réduire immédiatement le nombre de verrous à zéro.

Les demandes de verrouillage récursives sont toujours accordées immédiatement, sans placer le thread demandeur dans la file d’attente de l’enregistreur.

Pour obtenir des valeurs de délai d’attente valides, consultez ReaderWriterLock.

Voir aussi

• Threading managé
• ReaderWriterLock