ReaderWriterLock.AcquireWriterLock Metoda

Definice

Obor názvů:

System.Threading

Sestavení:

netstandard.dll, System.Threading.dll

Získá zámek zapisovače.

Přetížení

Name	Description
AcquireWriterLock(Int32)	Získá zámek zapisovače pomocí Int32 hodnoty pro časový limit.
AcquireWriterLock(TimeSpan)	Získá zámek zapisovače pomocí TimeSpan hodnoty pro časový limit.

AcquireWriterLock(Int32)

Zdroj:

ReaderWriterLock.cs

Získá zámek zapisovače pomocí Int32 hodnoty pro časový limit.

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 vyprší v milisekundách.

Výjimky

ApplicationException

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

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 poskytovaného ReaderWriterLock pro třídu.

// 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

// 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 má jiné vlákno zámek čtečky nebo zapisovače. Popis způsobu, jakým zapisovač zamkne alternativy s více souběžnými zámky čtečky, najdete v ReaderWriterLock třídě.

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

Caution

Pokud vlákno volá AcquireWriterLock , i když má stále zámek čtečky, zablokuje se jeho vlastní zámek čtečky. Pokud je zadán časový limit nekonečného časového limitu, vlákno zablokuje zablokování. Chcete-li se těmto zablokováním vyhnout, použijte IsReaderLockHeld k určení, zda aktuální vlákno již má zámek čtečky.

AcquireWriterLock podporuje rekurzivní požadavky zapisovače-lock. To znamená, že vlákno může volat AcquireWriterLock vícekrát, což zvýší počet zámků pokaždé. Musíte volat ReleaseWriterLock jednou pro každý hovor AcquireWriterLock. Případně můžete volat ReleaseLock , abyste snížili počet zámků na nulu okamžitě.

Rekurzivní žádosti o uzamčení se vždy udělí okamžitě, aniž by bylo nutné umístit vlákno žádosti do fronty zapisovače.

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

Viz také

• spravovaných vláken

AcquireWriterLock(TimeSpan)

Zdroj:

ReaderWriterLock.cs

Získá zámek zapisovače pomocí TimeSpan hodnoty pro časový limit.

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čení TimeSpan časového limitu.

Výjimky

ApplicationException

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

ArgumentOutOfRangeException

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

Poznámky

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

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

Caution

Pokud vlákno volá AcquireWriterLock , i když má stále zámek čtečky, zablokuje se jeho vlastní zámek čtečky. Pokud je zadán časový limit nekonečného časového limitu, vlákno zablokuje zablokování. Chcete-li se těmto zablokováním vyhnout, použijte IsReaderLockHeld k určení, zda aktuální vlákno již má zámek čtečky.

AcquireWriterLock podporuje rekurzivní požadavky zapisovače-lock. To znamená, že vlákno může volat AcquireWriterLock vícekrát, což zvýší počet zámků pokaždé. Musíte volat ReleaseWriterLock jednou pro každý hovor AcquireWriterLock. Případně můžete volat ReleaseLock , abyste snížili počet zámků na nulu okamžitě.

Rekurzivní žádosti o uzamčení se vždy udělí okamžitě, aniž by bylo nutné umístit vlákno žádosti do fronty zapisovače.

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

Viz také

• spravovaných vláken