ReaderWriterLock.AcquireReaderLock Метод

  • Ссылка

Определение

Пространство имен:
System.Threading
Сборка:
System.Threading.dll
Сборка:
mscorlib.dll
Сборка:
netstandard.dll

Получает блокировку чтения.

Перегрузки

AcquireReaderLock(Int32)

Получает блокировку чтения, используя значение Int32 для задания времени ожидания.
AcquireReaderLock(TimeSpan)

Получает блокировку чтения, используя значение TimeSpan для задания времени ожидания.

AcquireReaderLock(Int32)

Получает блокировку чтения, используя значение Int32 для задания времени ожидания.

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)

Параметры

millisecondsTimeout
Int32

Время ожидания в миллисекундах.

Атрибуты
UnsupportedOSPlatformAttribute

Исключения

ApplicationException

Время ожидания, заданное параметром millisecondsTimeout, истекло до удовлетворения запроса на блокировку.

Примеры

В следующем примере кода показано, как получить и освободить блокировку средства чтения и как обрабатывать исключение, возникающее при истечении времени ожидания запроса.

Этот код является частью более крупного примера, предоставленного ReaderWriterLock для класса.

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

Комментарии

AcquireReaderLock блокируется, если другой поток имеет блокировку записи или если по крайней мере один поток ожидает блокировки модуля записи.

Примечание

Если текущий поток уже имеет блокировку модуля записи, то блокировка чтения не будет получена. Вместо этого увеличивается число блокировок при блокировке модуля записи. Это предотвращает блокировку потока по собственной блокировке модуля записи. Результат точно такой же, как вызов AcquireWriterLock, и при освобождении блокировки модуля записи требуется дополнительный вызов ReleaseWriterLock .

AcquireReaderLock поддерживает запросы на рекурсивную блокировку чтения. То есть поток может вызывать AcquireReaderLock несколько раз, что увеличивает количество блокировок каждый раз. Каждый раз при вызове AcquireReaderLockнеобходимо вызывать ReleaseReaderLock один раз. Кроме того, можно немедленно ReleaseLock уменьшить число блокировок до нуля.

Запросы рекурсивной блокировки всегда предоставляются немедленно, не помещая запрашивающий поток в очередь чтения. Используйте рекурсивные блокировки с осторожностью, чтобы избежать блокировки запросов на запись в течение длительных периодов.

Допустимые значения времени ожидания см. в разделе ReaderWriterLock.

См. также раздел

Применяется к

AcquireReaderLock(TimeSpan)

Получает блокировку чтения, используя значение TimeSpan для задания времени ожидания.

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)

Параметры

timeout
TimeSpan

Период TimeSpan, задающий время ожидания.

Атрибуты
UnsupportedOSPlatformAttribute

Исключения

ApplicationException

Время ожидания, заданное параметром timeout, истекло до удовлетворения запроса на блокировку.

ArgumentOutOfRangeException

Параметр timeout содержит отрицательное значение, отличное от -1.

Комментарии

AcquireReaderLock блокируется, если другой поток имеет блокировку записи или если по крайней мере один поток ожидает блокировки модуля записи.

Примечание

Если текущий поток уже имеет блокировку модуля записи, то блокировка чтения не будет получена. Вместо этого увеличивается число блокировок при блокировке модуля записи. Это предотвращает блокировку потока по собственной блокировке модуля записи. Результат точно такой же, как вызов AcquireWriterLock, и при освобождении блокировки модуля записи требуется дополнительный вызов ReleaseWriterLock .

AcquireReaderLock поддерживает запросы на рекурсивную блокировку чтения. То есть поток может вызывать AcquireReaderLock несколько раз, что увеличивает количество блокировок каждый раз. Каждый раз при вызове AcquireReaderLockнеобходимо вызывать ReleaseReaderLock один раз. Кроме того, можно немедленно ReleaseLock уменьшить число блокировок до нуля.

Запросы рекурсивной блокировки всегда предоставляются немедленно, не помещая запрашивающий поток в очередь чтения. Используйте рекурсивные блокировки с осторожностью, чтобы избежать блокировки запросов на запись в течение длительных периодов.

Допустимые значения времени ожидания см. в разделе ReaderWriterLock.

См. также раздел

Применяется к