ReaderWriterLock.AnyWritersSince(Int32) Méthode

Référence

Définition

Espace de noms:: System.Threading

Assembly:: System.Threading.dll

Assembly:: mscorlib.dll

Assembly:: netstandard.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Indique si le verrou de writer a été accordé à un thread depuis l'obtention du numéro de séquence.

public:
 bool AnyWritersSince(int seqNum);

public bool AnyWritersSince (int seqNum);

member this.AnyWritersSince : int -> bool

Public Function AnyWritersSince (seqNum As Integer) As Boolean

Paramètres

seqNum: Int32

Numéro séquentiel.

Retours

Boolean

true si le verrou de writer a été accordé à un thread depuis l'obtention du numéro de séquence ; sinon, false.

Exemples

L’exemple de code suivant montre comment utiliser la AnyWritersSince méthode et la WriterSeqNum propriété pour déterminer si un autre thread a acquis le verrou writer sur la ressource protégée depuis que le thread actuel a conservé le verrou de l’enregistreur.

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 release all locks and later restore
// the lock state. Shows how to use sequence numbers
// to determine whether another thread has obtained
// a writer lock since this thread last accessed the
// resource.
static void ReleaseRestore( Random^ rnd, int timeOut )
{
   int lastWriter;
   try
   {
      rwl->AcquireReaderLock( timeOut );
      try
      {

         // It is safe for this thread to read from
         // the shared resource. Cache the value. (You
         // might do this if reading the resource is
         // an expensive operation.)
         int resourceValue = resource;
         Display( String::Format( "reads resource value {0}", resourceValue ) );
         Interlocked::Increment( reads );

         // Save the current writer sequence number.
         lastWriter = rwl->WriterSeqNum;

         // Release the lock, and save a cookie so the
         // lock can be restored later.
         LockCookie lc = rwl->ReleaseLock();

         // Wait for a random interval (up to a
         // quarter of a second), and then restore
         // the previous state of the lock. Note that
         // there is no timeout on the Restore method.
         Thread::Sleep( rnd->Next( 250 ) );
         rwl->RestoreLock( lc );

         // Check whether other threads obtained the
         // writer lock in the interval. If not, then
         // the cached value of the resource is still
         // valid.
         if ( rwl->AnyWritersSince( lastWriter ) )
         {
            resourceValue = resource;
            Interlocked::Increment( reads );
            Display( String::Format( "resource has changed {0}", resourceValue ) );
         }
         else
         {
            Display( String::Format( "resource has not changed {0}", resourceValue ) );
         }
      }
      finally
      {

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

   }
   catch ( ApplicationException^ )
   {

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

}

// Release all locks and later restores the lock state.
// Uses sequence numbers to determine whether another thread has
// obtained a writer lock since this thread last accessed the resource.
static void ReleaseRestore(Random rnd, int timeOut)
{
   int lastWriter;

   try {
      rwl.AcquireReaderLock(timeOut);
      try {
         // It's safe for this thread to read from the shared resource,
         // so read and cache the resource value.
         int resourceValue = resource;     // Cache the resource value.
         Display("reads resource value " + resourceValue);
         Interlocked.Increment(ref reads);

         // Save the current writer sequence number.
         lastWriter = rwl.WriterSeqNum;

         // Release the lock and save a cookie so the lock can be restored later.
         LockCookie lc = rwl.ReleaseLock();

         // Wait for a random interval and then restore the previous state of the lock.
         Thread.Sleep(rnd.Next(250));
         rwl.RestoreLock(ref lc);

         // Check whether other threads obtained the writer lock in the interval.
         // If not, then the cached value of the resource is still valid.
         if (rwl.AnyWritersSince(lastWriter)) {
            resourceValue = resource;
            Interlocked.Increment(ref reads);
            Display("resource has changed " + resourceValue);
         }
         else {
            Display("resource has not changed " + resourceValue);
         }
      }
      finally {
         // Ensure that the lock is released.
         rwl.ReleaseReaderLock();
      }
   }
   catch (ApplicationException) {
      // The reader lock request timed out.
      Interlocked.Increment(ref readerTimeouts);
   }
}

' Release all locks and later restores the lock state.
' Uses sequence numbers to determine whether another thread has
' obtained a writer lock since this thread last accessed the resource.
Sub ReleaseRestore(rnd As Random ,timeOut As Integer)
   Dim lastWriter As Integer
   
   Try
      rwl.AcquireReaderLock(timeOut)
      Try
         ' It's safe for this thread to read from the shared resource,
         ' so read and cache the resource value.
         Dim resourceValue As Integer = resource
         Display("reads resource value " & resourceValue)
         Interlocked.Increment(reads)
         
         ' Save the current writer sequence number.
         lastWriter = rwl.WriterSeqNum
         
         ' Release the lock and save a cookie so the lock can be restored later.
         Dim lc As LockCookie = rwl.ReleaseLock()
         
         ' Wait for a random interval and then restore the previous state of the lock.
         Thread.Sleep(rnd.Next(250))
         rwl.RestoreLock(lc)
        
         ' Check whether other threads obtained the writer lock in the interval.
         ' If not, then the cached value of the resource is still valid.
         If rwl.AnyWritersSince(lastWriter) Then
            resourceValue = resource
            Interlocked.Increment(reads)
            Display("resource has changed " & resourceValue)
         Else
            Display("resource has not changed " & resourceValue)
         End If
      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

Vous pouvez utiliser WriterSeqNum et AnyWritersSince améliorer les performances des applications. Par exemple, un thread peut mettre en cache les informations qu’il obtient lors de la conservation d’un verrou de lecteur. Après la libération et la reprise ultérieure du verrou, le thread peut utiliser AnyWritersSince pour déterminer si d’autres threads ont écrit dans la ressource pendant l’intervalle ; sinon, les informations mises en cache peuvent être utilisées. Cette technique est utile lorsque la lecture des informations protégées par le verrou est coûteuse ; par exemple, l’exécution d’une requête de base de données.

L’appelant doit contenir un verrou de lecteur ou un verrou d’enregistreur pour que le numéro de séquence soit utile.

S’applique à