ReaderWriterLock.AcquireReaderLock 方法

定義

命名空間:

System.Threading

組件:

netstandard.dll, System.Threading.dll

獲得讀取鎖。

多載

名稱	Description
AcquireReaderLock(Int32)	取得讀取鎖，並以 Int32 逾時值計算。
AcquireReaderLock(TimeSpan)	取得讀取鎖，並使用 TimeSpan 逾時值。

AcquireReaderLock(Int32)

來源:

ReaderWriterLock.cs

取得讀取鎖，並以 Int32 逾時值計算。

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)

參數

millisecondsTimeout

Int32

時間只需毫秒。

屬性

UnsupportedOSPlatformAttribute

例外狀況

ApplicationException

millisecondsTimeout 在鎖申請獲准前就已過期。

範例

以下程式碼範例說明如何取得並釋放讀取鎖，以及如何處理請求逾時拋出的例外。

此程式碼是該類別更大 ReaderWriterLock 範例的一部分。

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

備註

AcquireReaderLock 如果其他執行緒有寫入鎖定，或至少有一個執行緒在等待寫入鎖定，就會被阻塞。

備註

如果目前執行緒已經有寫入鎖，則不會取得讀取鎖。 相反地，寫入鎖的鎖數會增加。 這可以防止執行緒在自己的寫入鎖定上阻塞。 結果與呼叫 AcquireWriterLock完全相同，且在釋放寫入鎖定時需額外呼叫 。ReleaseWriterLock

AcquireReaderLock 支援遞迴讀取鎖定請求。 也就是說，一個執行緒可以多次呼叫 AcquireReaderLock，每次都會增加鎖的數量。 你必須為每次撥打ReleaseReaderLock電話撥打AcquireReaderLock一次。 或者，你也可以立即打電話 ReleaseLock 將鎖數降為零。

遞迴鎖請求總是立即被授予，且不會將請求的執行緒放入讀取佇列。 使用遞迴鎖時要謹慎，避免長時間阻擋寫入鎖定請求。

關於有效的逾時值，請參見 ReaderWriterLock。

另請參閱

• 管理的執行緒

AcquireReaderLock(TimeSpan)

來源:

ReaderWriterLock.cs

取得讀取鎖，並使用 TimeSpan 逾時值。

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)

參數

timeout

TimeSpan

A TimeSpan 指定了暫停期間。

屬性

UnsupportedOSPlatformAttribute

例外狀況

ApplicationException

timeout 在鎖申請獲准前就已過期。

ArgumentOutOfRangeException

timeout 指定除 -1 毫秒外的負值。

備註

AcquireReaderLock 如果其他執行緒有寫入鎖定，或至少有一個執行緒在等待寫入鎖定，就會被阻塞。

備註

如果目前執行緒已經有寫入鎖，則不會取得讀取鎖。 相反地，寫入鎖的鎖數會增加。 這可以防止執行緒在自己的寫入鎖定上阻塞。 結果與呼叫 AcquireWriterLock完全相同，且在釋放寫入鎖定時需額外呼叫 。ReleaseWriterLock

AcquireReaderLock 支援遞迴讀取鎖定請求。 也就是說，一個執行緒可以多次呼叫 AcquireReaderLock，每次都會增加鎖的數量。 你必須為每次撥打ReleaseReaderLock電話撥打AcquireReaderLock一次。 或者，你也可以立即打電話 ReleaseLock 將鎖數降為零。

遞迴鎖請求總是立即被授予，且不會將請求的執行緒放入讀取佇列。 使用遞迴鎖時要謹慎，避免長時間阻擋寫入鎖定請求。

關於有效的逾時值，請參見 ReaderWriterLock。

另請參閱

• 管理的執行緒