ReaderWriterLock.AcquireWriterLock Metoda

Definice

Obor názvů:

System.Threading

Sestavení:

System.Threading.dll

Získá zámek zapisovače.

Přetížení

AcquireWriterLock(Int32)	Získá zámek zapisovače pomocí Int32 hodnoty časového limitu.
AcquireWriterLock(TimeSpan)	Získá zámek zapisovače pomocí TimeSpan hodnoty pro vypršení časového limitu.

AcquireWriterLock(Int32)

Zdroj:

ReaderWriterLock.cs

Získá zámek zapisovače pomocí Int32 hodnoty časového limitu.

public:
 void AcquireWriterLock(int millisecondsTimeout);

public void AcquireWriterLock (int millisecondsTimeout);

member this.AcquireWriterLock : int -> unit

Public Sub AcquireWriterLock (millisecondsTimeout As Integer)

Parametry

millisecondsTimeout

Int32

Časový limit v milisekundách

Výjimky

ApplicationException

timeout vyprší před udělením žádosti o uzamčení.

Příklady

Následující příklad kódu ukazuje, jak získat a uvolnit zámek zapisovače a jak zpracovat výjimku vyvolanou při vypršení časového limitu požadavku.

Tento kód je součástí většího příkladu ReaderWriterLock , který je k dispozici 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 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

Poznámky

Tato metoda blokuje, pokud jiné vlákno má zámek čtečky nebo zámek zapisovače. Popis způsobu, jakým se zámek zapisovače střídá s několika souběžnými zámky čtečky, najdete ve ReaderWriterLock třídě.

Vlákno, které už má zámek čtečky, může zámek zapisovače získat jedním ze dvou způsobů: uvolněním zámku čtečky před voláním AcquireWriterLocknebo voláním UpgradeToWriterLock.

Upozornění

Pokud vlákno volá AcquireWriterLock , zatímco má stále zámek čtečky, zablokuje vlastní zámek čtečky. Pokud je zadaný nekonečný časový limit, vlákno se zablokuje. Pokud se chcete takovým vzájemným zablokováním vyhnout, použijte IsReaderLockHeld k určení, jestli má aktuální vlákno již zámek čtečky.

AcquireWriterLock podporuje rekurzivní žádosti o zámek zapisovače. To znamená, že vlákno může volat AcquireWriterLock vícekrát, což pokaždé zvýší počet zámků. Při každém volání AcquireWriterLockmusíte volat ReleaseWriterLock jednou . Případně můžete volat ReleaseLock a okamžitě snížit počet zámků na nulu.

Žádosti o rekurzivní zámek se vždy udělují okamžitě, aniž by bylo nutné umístit požadované vlákno do fronty zapisovače.

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

Viz také

• Spravované vlákno
• Readerwriterlock

AcquireWriterLock(TimeSpan)

Zdroj:

ReaderWriterLock.cs

Získá zámek zapisovače pomocí TimeSpan hodnoty pro vypršení časového limitu.

public:
 void AcquireWriterLock(TimeSpan timeout);

public void AcquireWriterLock (TimeSpan timeout);

member this.AcquireWriterLock : TimeSpan -> unit

Public Sub AcquireWriterLock (timeout As TimeSpan)

Parametry

timeout

TimeSpan

Určuje TimeSpan dobu časového limitu.

Výjimky

ApplicationException

timeout vyprší před udělením žádosti o uzamčení.

ArgumentOutOfRangeException

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

Poznámky

Tato metoda blokuje, pokud jiné vlákno má zámek čtečky nebo zámek zapisovače. Popis způsobu, jakým se zámek zapisovače střídá s několika souběžnými zámky čtečky, najdete ve ReaderWriterLock třídě.

Vlákno, které už má zámek čtečky, může zámek zapisovače získat jedním ze dvou způsobů: uvolněním zámku čtečky před voláním AcquireWriterLocknebo voláním UpgradeToWriterLock.

Upozornění

Pokud vlákno volá AcquireWriterLock , zatímco má stále zámek čtečky, zablokuje vlastní zámek čtečky. Pokud je zadaný nekonečný časový limit, vlákno se zablokuje. Pokud se chcete takovým vzájemným zablokováním vyhnout, použijte IsReaderLockHeld k určení, jestli má aktuální vlákno již zámek čtečky.

AcquireWriterLock podporuje rekurzivní žádosti o zámek zapisovače. To znamená, že vlákno může volat AcquireWriterLock vícekrát, což pokaždé zvýší počet zámků. Při každém volání AcquireWriterLockmusíte volat ReleaseWriterLock jednou . Případně můžete volat ReleaseLock a okamžitě snížit počet zámků na nulu.

Žádosti o rekurzivní zámek se vždy udělují okamžitě, aniž by bylo nutné umístit požadované vlákno do fronty zapisovače.

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

Viz také

• Spravované vlákno
• Readerwriterlock