ReaderWriterLock.AcquireReaderLock Metoda

Definice

Obor názvů:

System.Threading

Sestavení:

netstandard.dll, System.Threading.dll

Získá zámek čtečky.

Přetížení

Name	Description
AcquireReaderLock(Int32)	Získá zámek čtečky s použitím Int32 hodnoty pro časový limit.
AcquireReaderLock(TimeSpan)	Získá zámek čtečky s použitím TimeSpan hodnoty pro časový limit.

AcquireReaderLock(Int32)

Zdroj:

ReaderWriterLock.cs

Získá zámek čtečky s použitím Int32 hodnoty pro časový limit.

public:
 void AcquireReaderLock(int millisecondsTimeout);

[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public void AcquireReaderLock(int millisecondsTimeout);

[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
member this.AcquireReaderLock : int -> unit

Public Sub AcquireReaderLock (millisecondsTimeout As Integer)

Parametry

millisecondsTimeout

Int32

Časový limit vyprší v milisekundách.

Atributy

UnsupportedOSPlatformAttribute

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 čtečky 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 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

Poznámky

AcquireReaderLock blokuje, pokud má jiné vlákno zámek zapisovače nebo pokud alespoň jedno vlákno čeká na zámek zapisovače.

Note

Pokud aktuální vlákno již má zámek zapisovače, není získán žádný zámek čtečky. Místo toho se zvýší počet zámků na zámek zapisovače. Tím zabráníte blokování vlákna na vlastním zámku zapisovače. Výsledek je úplně stejný jako volání AcquireWriterLocka při uvolnění zámku zapisovače se vyžaduje další volání ReleaseWriterLock .

AcquireReaderLock podporuje rekurzivní žádosti o uzamčení čtečky. To znamená, že vlákno může volat AcquireReaderLock vícekrát, což zvýší počet zámků pokaždé. Musíte volat ReleaseReaderLock jednou pro každý hovor AcquireReaderLock. 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 čtenáře. Používejte rekurzivní zámky s opatrností, abyste se vyhnuli blokování požadavků zapisovače po dlouhou dobu.

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

Viz také

• spravovaných vláken
• Readerwriterlock

AcquireReaderLock(TimeSpan)

Zdroj:

ReaderWriterLock.cs

Získá zámek čtečky s použitím TimeSpan hodnoty pro časový limit.

public:
 void AcquireReaderLock(TimeSpan timeout);

[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public void AcquireReaderLock(TimeSpan timeout);

[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
member this.AcquireReaderLock : TimeSpan -> unit

Public Sub AcquireReaderLock (timeout As TimeSpan)

Parametry

timeout

TimeSpan

A TimeSpan specifying the time-out period.

Atributy

UnsupportedOSPlatformAttribute

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

AcquireReaderLock blokuje, pokud má jiné vlákno zámek zapisovače nebo pokud alespoň jedno vlákno čeká na zámek zapisovače.

Note

Pokud aktuální vlákno již má zámek zapisovače, není získán žádný zámek čtečky. Místo toho se zvýší počet zámků na zámek zapisovače. Tím zabráníte blokování vlákna na vlastním zámku zapisovače. Výsledek je úplně stejný jako volání AcquireWriterLocka při uvolnění zámku zapisovače se vyžaduje další volání ReleaseWriterLock .

AcquireReaderLock podporuje rekurzivní žádosti o uzamčení čtečky. To znamená, že vlákno může volat AcquireReaderLock vícekrát, což zvýší počet zámků pokaždé. Musíte volat ReleaseReaderLock jednou pro každý hovor AcquireReaderLock. 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 čtenáře. Používejte rekurzivní zámky s opatrností, abyste se vyhnuli blokování požadavků zapisovače po dlouhou dobu.

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

Viz také

• spravovaných vláken
• Readerwriterlock