ReaderWriterLockSlim.EnterReadLock Método

Definição

Espaço de Nomes:

System.Threading

Assemblagem:

System.Core.dll

Tenta entrar no bloqueio em modo de leitura.

public:
 void EnterReadLock();

public void EnterReadLock();

member this.EnterReadLock : unit -> unit

Public Sub EnterReadLock ()

Exceções

LockRecursionException

A RecursionPolicy propriedade é NoRecursion, e o thread atual tentou adquirir o bloqueio de leitura quando já detém o bloqueio de leitura.

-ou-

A RecursionPolicy propriedade é NoRecursion, e a thread atual tentou adquirir o bloqueio de leitura quando já detém o bloqueio de escrita.

-ou-

O número de recursão excederia a capacidade do contador. Este limite é tão grande que as candidaturas nunca deveriam encontrar esta exceção.

ObjectDisposedException

O ReaderWriterLockSlim objeto foi descartado.

Exemplos

O exemplo seguinte mostra como usar o EnterReadLock método para entrar na fechadura em modo de leitura. O método mostrado no exemplo recupera o valor associado a uma chave. Se a chave não for encontrada, a exceção lançada pelo interior Dictionary<TKey,TValue> pode terminar o método. Um bloco é usado para executar o ExitReadLock método, garantindo que o chamador sai do finally modo de leitura.

Este código faz parte de um exemplo mais amplo fornecido para a ReaderWriterLockSlim turma.

private ReaderWriterLockSlim cacheLock = new ReaderWriterLockSlim();
private Dictionary<int, string> innerCache = new Dictionary<int, string>();

Private cacheLock As New ReaderWriterLockSlim()
Private innerCache As New Dictionary(Of Integer, String)

public string Read(int key)
{
    cacheLock.EnterReadLock();
    try
    {
        return innerCache[key];
    }
    finally
    {
        cacheLock.ExitReadLock();
    }
}

Public Function Read(ByVal key As Integer) As String
    cacheLock.EnterReadLock()
    Try
        Return innerCache(key)
    Finally
        cacheLock.ExitReadLock()
    End Try
End Function

Observações

Este método bloqueia até que o thread que chama entre no bloqueio e, portanto, pode nunca mais regressar. Use o TryEnterReadLock método para bloquear durante um intervalo especificado e depois retorne se o thread que chama não tiver entrado em modo de leitura durante esse intervalo.

Múltiplas threads podem entrar em modo de leitura ao mesmo tempo.

Se uma ou mais threads estiverem à espera de entrar em modo de escrita, uma thread que chama o EnterReadLock método bloqueia-se até que essas threads tenham expirado o tempo ou entrado em modo de escrita e depois saíam desse modo.

Note

Se um bloqueio permitir recursão, um thread que entrou no lock em modo de leitura pode entrar no modo de leitura recursivamente, mesmo que outros threads estejam à espera de entrar no modo de escrita.

No máximo, um thread pode estar em modo atualizável enquanto os outros estão em modo de leitura. Se houver threads adicionais à espera de entrar em modo atualizável, e não houver threads à espera para entrar no modo de escrita, os threads que chamam o EnterReadLock método entram imediatamente no modo de leitura e não bloqueiam.