ReaderWriterLock.AcquireReaderLock Méthode

Définition

Espace de noms:

System.Threading

Assembly:

System.Threading.dll

Assembly:

mscorlib.dll

Assembly:

netstandard.dll

Acquiert un verrou de lecteur.

Surcharges

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

AcquireReaderLock(Int32)

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

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)

Paramètres

millisecondsTimeout

Int32

Délai en millisecondes.

Attributs

UnsupportedOSPlatformAttribute

Exceptions

ApplicationException

millisecondsTimeout 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 de lecteur et comment gérer l’exception levée lorsqu’une requête expire.

Ce code fait partie d’un exemple plus grand 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 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

Remarques

AcquireReaderLock bloque si un autre thread a le verrou de l’enregistreur ou si au moins un thread attend le verrou de l’enregistreur.

Notes

Si le thread actuel dispose déjà du verrou de l’enregistreur, aucun verrou de lecteur n’est acquis. Au lieu de cela, le nombre de verrous sur le verrou de l’enregistreur est incrémenté. Cela empêche un thread de bloquer sur son propre verrou d’enregistreur. Le résultat est exactement identique à l’appel AcquireWriterLock, et un appel supplémentaire est ReleaseWriterLock requis lors de la libération du verrou de l’enregistreur.

AcquireReaderLock prend en charge les demandes de verrouillage de lecteur récursives. Autrement dit, un thread peut appeler AcquireReaderLock plusieurs fois, ce qui incrémente le nombre de verrous chaque fois. Vous devez appeler ReleaseReaderLock une fois pour chaque fois que vous appelez AcquireReaderLock. Vous pouvez également appeler ReleaseLock pour réduire le nombre de verrous à zéro immédiatement.

Les demandes de verrouillage récursives sont toujours accordées immédiatement, sans placer le thread demandeur dans la file d’attente du lecteur. Utilisez des verrous récursifs avec prudence, pour éviter de bloquer les demandes de verrouillage d’enregistreur pendant de longues périodes.

Pour connaître les valeurs de délai d’expiration valides, consultez ReaderWriterLock.

Voir aussi

• Threading managé
• ReaderWriterLock

AcquireReaderLock(TimeSpan)

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

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)

Paramètres

timeout

TimeSpan

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

Attributs

UnsupportedOSPlatformAttribute

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

AcquireReaderLock bloque si un autre thread a le verrou de l’enregistreur ou si au moins un thread attend le verrou de l’enregistreur.

Notes

Si le thread actuel dispose déjà du verrou de l’enregistreur, aucun verrou de lecteur n’est acquis. Au lieu de cela, le nombre de verrous sur le verrou de l’enregistreur est incrémenté. Cela empêche un thread de bloquer sur son propre verrou d’enregistreur. Le résultat est exactement identique à l’appel AcquireWriterLock, et un appel supplémentaire est ReleaseWriterLock requis lors de la libération du verrou de l’enregistreur.

AcquireReaderLock prend en charge les demandes de verrouillage de lecteur récursives. Autrement dit, un thread peut appeler AcquireReaderLock plusieurs fois, ce qui incrémente le nombre de verrous chaque fois. Vous devez appeler ReleaseReaderLock une fois pour chaque fois que vous appelez AcquireReaderLock. Vous pouvez également appeler ReleaseLock pour réduire le nombre de verrous à zéro immédiatement.

Les demandes de verrouillage récursives sont toujours accordées immédiatement, sans placer le thread demandeur dans la file d’attente du lecteur. Utilisez des verrous récursifs avec prudence, pour éviter de bloquer les demandes de verrouillage d’enregistreur pendant de longues périodes.

Pour connaître les valeurs de délai d’expiration valides, consultez ReaderWriterLock.

Voir aussi

• Threading managé
• ReaderWriterLock