Sdílet prostřednictvím


ReaderWriterLock.UpgradeToWriterLock Metoda

Definice

Upgraduje zámek čtečky na zámek zapisovače.

Přetížení

UpgradeToWriterLock(Int32)

Upgraduje zámek čtečky na zámek zapisovače s použitím Int32 hodnoty pro časový limit.

UpgradeToWriterLock(TimeSpan)

Upgraduje zámek čtečky na zámek zapisovače pomocí TimeSpan hodnoty pro vypršení časového limitu.

UpgradeToWriterLock(Int32)

Zdroj:
ReaderWriterLock.cs
Zdroj:
ReaderWriterLock.cs
Zdroj:
ReaderWriterLock.cs

Upgraduje zámek čtečky na zámek zapisovače s použitím Int32 hodnoty pro časový limit.

public:
 System::Threading::LockCookie UpgradeToWriterLock(int millisecondsTimeout);
public System.Threading.LockCookie UpgradeToWriterLock (int millisecondsTimeout);
[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public System.Threading.LockCookie UpgradeToWriterLock (int millisecondsTimeout);
member this.UpgradeToWriterLock : int -> System.Threading.LockCookie
[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
member this.UpgradeToWriterLock : int -> System.Threading.LockCookie
Public Function UpgradeToWriterLock (millisecondsTimeout As Integer) As LockCookie

Parametry

millisecondsTimeout
Int32

Časový limit v milisekundách.

Návraty

Hodnota LockCookie .

Atributy

Výjimky

millisecondsTimeout vyprší před udělením žádosti o zámek.

Příklady

Následující příklad kódu ukazuje, jak požádat o zámek čtenáře, upgradovat zámek čtečky na zámek zapisovače a downgradovat na zámek čtenáře znovu.

Tento kód je součástí většího příkladu ReaderWriterLock pro třídu .

// 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 a reader lock, upgrade the
// reader lock to the writer lock, and downgrade to a
// reader lock again.
static void UpgradeDowngrade( Random^ rnd, 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 );

         // If it is necessary to write to the resource,
         // you must either release the reader lock and
         // then request the writer lock, or upgrade the
         // reader lock. Note that upgrading the reader lock
         // puts the thread in the write queue, behind any
         // other threads that might be waiting for the
         // writer lock.
         try
         {
            LockCookie lc = rwl->UpgradeToWriterLock( 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->DowngradeFromWriterLock( lc );
            }

         }
         catch ( ApplicationException^ )
         {

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


         // When the lock has been downgraded, it is
         // still safe to read from the 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 );
   }

}
// Requests a reader lock, upgrades the reader lock to the writer
// lock, and downgrades it to a reader lock again.
static void UpgradeDowngrade(Random rnd, int timeOut)
{
   try {
      rwl.AcquireReaderLock(timeOut);
      try {
         // It's safe for this thread to read from the shared resource.
         Display("reads resource value " + resource);
         Interlocked.Increment(ref reads);

         // To write to the resource, either release the reader lock and
         // request the writer lock, or upgrade the reader lock. Upgrading
         // the reader lock puts the thread in the write queue, behind any
         // other threads that might be waiting for the writer lock.
         try {
            LockCookie lc = rwl.UpgradeToWriterLock(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(ref writes);
            }
            finally {
               // Ensure that the lock is released.
               rwl.DowngradeFromWriterLock(ref lc);
            }
         }
         catch (ApplicationException) {
            // The upgrade request timed out.
            Interlocked.Increment(ref writerTimeouts);
         }

         // If the lock was downgraded, it's still safe to read from the 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);
   }
}
' Requests a reader lock, upgrades the reader lock to the writer
' lock, and downgrades it to a reader lock again.
Sub UpgradeDowngrade(rnd As Random, 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)
         
         ' To write to the resource, either release the reader lock and
         ' request the writer lock, or upgrade the reader lock. Upgrading
         ' the reader lock puts the thread in the write queue, behind any
         ' other threads that might be waiting for the writer lock.
         Try
            Dim lc As LockCookie = rwl.UpgradeToWriterLock(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.DowngradeFromWriterLock(lc)
            End Try
         Catch ex As ApplicationException
            ' The upgrade request timed out.
            Interlocked.Increment(writerTimeouts)
         End Try
         
         ' If the lock was downgraded, it's still safe to read from the 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

Poznámky

Když vlákno volá UpgradeToWriterLock zámek čtečky je uvolněna, bez ohledu na počet zámků, a vlákno přejde na konec fronty pro zámek zapisovače. Proto mohou jiná vlákna zapisovat do prostředku předtím, než vláknu, které požadovalo upgrade, udělen zámek zapisovače.

Důležité

Výjimka časového limitu není vyvolána, dokud vlákno, které volal metodu UpgradeToWriterLock může znovu získat zámek čtenáře. Pokud na zámek zapisovače nečekají žádná další vlákna, dojde k tomu okamžitě. Pokud je však další vlákno zařazeno do fronty pro zámek zápisu, vlákno, které volal UpgradeToWriterLock metodu nemůže znovu získat zámek čtenáře, dokud všichni aktuální čtenáři neuvolní své zámky a jedno vlákno získalo a uvolnilo zámek zapisovače. To platí i v případě, že druhé vlákno, které požadovalo zámek zápisu, o to požádalo po aktuálním vlákně volané metodou UpgradeToWriterLock .

Pokud chcete obnovit stav zámku, zavolejte metodu DowngradeFromWriterLockLockCookie vrácenou metodou UpgradeToWriterLock. Nepoužívejte tuto LockCookie možnost s RestoreLocknástrojem .

Pokud vlákno nemá zámek čtečky, nepoužívejte UpgradeToWriterLock. Místo toho použijte AcquireWriterLock.

Platné hodnoty časového limitu najdete v tématu ReaderWriterLock.

Viz také

Platí pro

UpgradeToWriterLock(TimeSpan)

Zdroj:
ReaderWriterLock.cs
Zdroj:
ReaderWriterLock.cs
Zdroj:
ReaderWriterLock.cs

Upgraduje zámek čtečky na zámek zapisovače pomocí TimeSpan hodnoty pro vypršení časového limitu.

public:
 System::Threading::LockCookie UpgradeToWriterLock(TimeSpan timeout);
public System.Threading.LockCookie UpgradeToWriterLock (TimeSpan timeout);
[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public System.Threading.LockCookie UpgradeToWriterLock (TimeSpan timeout);
member this.UpgradeToWriterLock : TimeSpan -> System.Threading.LockCookie
[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
member this.UpgradeToWriterLock : TimeSpan -> System.Threading.LockCookie
Public Function UpgradeToWriterLock (timeout As TimeSpan) As LockCookie

Parametry

timeout
TimeSpan

Určuje TimeSpan dobu časového limitu.

Návraty

Hodnota LockCookie .

Atributy

Výjimky

timeout vyprší před udělením žádosti o zámek.

timeout určuje zápornou hodnotu jinou než -1 milisekund.

Poznámky

Když vlákno volá UpgradeToWriterLock zámek čtečky je uvolněna, bez ohledu na počet zámků, a vlákno přejde na konec fronty pro zámek zapisovače. Proto mohou jiná vlákna zapisovat do prostředku předtím, než vláknu, které požadovalo upgrade, udělen zámek zapisovače.

Důležité

Výjimka časového limitu není vyvolána, dokud vlákno, které volal metodu UpgradeToWriterLock může znovu získat zámek čtenáře. Pokud na zámek zapisovače nečekají žádná další vlákna, dojde k tomu okamžitě. Pokud je však další vlákno zařazeno do fronty pro zámek zápisu, vlákno, které volal UpgradeToWriterLock metodu nemůže znovu získat zámek čtenáře, dokud všichni aktuální čtenáři neuvolní své zámky a jedno vlákno získalo a uvolnilo zámek zapisovače. To platí i v případě, že druhé vlákno, které požadovalo zámek zápisu, o to požádalo po aktuálním vlákně volané metodou UpgradeToWriterLock .

Pokud chcete obnovit stav zámku, zavolejte metodu DowngradeFromWriterLockLockCookie vrácenou metodou UpgradeToWriterLock. Nepoužívejte tuto LockCookie možnost s RestoreLocknástrojem .

Pokud vlákno nemá zámek čtečky, nepoužívejte UpgradeToWriterLock. Místo toho použijte AcquireWriterLock.

Platné hodnoty časového limitu najdete v tématu ReaderWriterLock.

Viz také

Platí pro