ReaderWriterLock.AcquireReaderLock Metoda

public:
 void AcquireReaderLock(int millisecondsTimeout);

public void AcquireReaderLock (int millisecondsTimeout);

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

member this.AcquireReaderLock : int -> unit

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

Public Sub AcquireReaderLock (millisecondsTimeout As Integer)

Parametry

Atributy

UnsupportedOSPlatformAttribute

Výjimky

Příklady

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

Tento kód je součástí většího příkladu zadaného 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 and release a reader lock, and
// how to 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( 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 );
   }

}

// 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č nebo pokud alespoň jedno vlákno čeká na zámek zapisovače.

AcquireReaderLock podporuje rekurzivní žádosti o uzamčení čtečky. To znamená, že vlákno může volat AcquireReaderLock několikrát, což zvýší počet zámků pokaždé. Pokaždé, když zavoláte, musíte volat ReleaseReaderLock AcquireReaderLockjednou. Alternativně můžete volat ReleaseLock , abyste snížili počet zámků na nulu okamžitě.

Rekurzivní žádosti o zámek jsou vždy uděleny 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í žádostí o zámek zapisovačů po dlouhou dobu.

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

Viz také

• Dělení na spravovaná vlákna
• Readerwriterlock

public:
 void AcquireReaderLock(TimeSpan timeout);

public void AcquireReaderLock (TimeSpan timeout);

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

member this.AcquireReaderLock : TimeSpan -> unit

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

Public Sub AcquireReaderLock (timeout As TimeSpan)

Parametry

Atributy

UnsupportedOSPlatformAttribute

Výjimky

Poznámky

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

AcquireReaderLock podporuje rekurzivní žádosti o uzamčení čtečky. To znamená, že vlákno může volat AcquireReaderLock několikrát, což zvýší počet zámků pokaždé. Pokaždé, když zavoláte, musíte volat ReleaseReaderLock AcquireReaderLockjednou. Alternativně můžete volat ReleaseLock , abyste snížili počet zámků na nulu okamžitě.

Rekurzivní žádosti o zámek jsou vždy uděleny 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í žádostí o zámek zapisovačů po dlouhou dobu.

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

Viz také

• Dělení na spravovaná vlákna
• Readerwriterlock