ReaderWriterLockSlim.EnterWriteLock Método

Definição

Tenta entrar no bloqueio em modo de gravação.Tries to enter the lock in write mode.

public:
 void EnterWriteLock();
public void EnterWriteLock ();
member this.EnterWriteLock : unit -> unit
Public Sub EnterWriteLock ()

Exceções

A propriedade RecursionPolicy é NoRecursion e o thread atual já entrou no bloqueio em qualquer modo.The RecursionPolicy property is NoRecursion and the current thread has already entered the lock in any mode.

- ou --or- O thread atual entrou no modo de leitura e ainda não tem um bloqueio de gravação. Portanto, tentar entrar no bloqueio em modo de gravação criará a possibilidade de um deadlock.The current thread has entered read mode and doesn't already own a write lock, so trying to enter the lock in write mode would create the possibility of a deadlock.

- ou --or- O número de recursão excederia a capacidade do contador.The recursion number would exceed the capacity of the counter. O limite é tão grande que os aplicativos nunca o alcançariam.The limit is so large that applications should never encounter it.

O objeto ReaderWriterLockSlim foi descartado.The ReaderWriterLockSlim object has been disposed.

Exemplos

O exemplo a seguir mostra como usar o EnterWriteLock método para inserir o bloqueio no modo de gravação.The following example shows how to use the EnterWriteLock method to enter the lock in write mode. O método mostrado no exemplo adiciona um novo par de chave/valor ao cache sincronizado.The method shown in the example adds a new key/value pair to the synchronized cache. Se a chave já estiver no cache, a exceção gerada pelo interior Dictionary<TKey,TValue> será permitida para encerrar o método.If the key is already in the cache, the exception thrown by the inner Dictionary<TKey,TValue> is allowed to terminate the method. Um finally bloco é usado para executar o ExitWriteLock método, garantindo que o chamador saia do modo de gravação.A finally block is used to execute the ExitWriteLock method, ensuring that the caller exits write mode.

Esse código é parte de um exemplo maior fornecido para a ReaderWriterLockSlim classe.This code is part of a larger example provided for the ReaderWriterLockSlim class.

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 void Add(int key, string value)
{
    cacheLock.EnterWriteLock();
    try
    {
        innerCache.Add(key, value);
    }
    finally
    {
        cacheLock.ExitWriteLock();
    }
}
Public Sub Add(ByVal key As Integer, ByVal value As String)
    cacheLock.EnterWriteLock()
    Try
        innerCache.Add(key, value)
    Finally
        cacheLock.ExitWriteLock()
    End Try
End Sub

Comentários

Esse método é bloqueado até que o thread de chamada Insira o bloqueio e, portanto, talvez nunca retorne.This method blocks until the calling thread enters the lock, and therefore might never return. Use o TryEnterWriteLock método a ser bloqueado para um intervalo especificado e, em seguida, retorne se o thread de chamada não tiver inserido o modo de gravação durante esse intervalo.Use the TryEnterWriteLock method to block for a specified interval, and then return if the calling thread has not entered write mode during that interval.

Se outros threads tiverem inserido o bloqueio no modo de leitura, um thread que chama o EnterWriteLock método é bloqueado até que esses threads tenham saído do modo de leitura.If other threads have entered the lock in read mode, a thread that calls the EnterWriteLock method blocks until those threads have exited read mode. Quando há threads aguardando para entrar no modo de gravação, os threads adicionais que tentam entrar no modo de leitura ou em um bloco de modo atualizável até que todos os threads esperando para entrar no modo de gravação tenham expirado ou inserido no modo de gravação e, em seguida, saiu dele.When there are threads waiting to enter write mode, additional threads that try to enter read mode or upgradeable mode block until all the threads waiting to enter write mode have either timed out or entered write mode and then exited from it.

Observação

Se um bloqueio permitir a recursão, um thread que entrou no modo de gravação poderá entrar no modo de gravação recursivamente, mesmo que outros threads estejam aguardando para entrar no modo de gravação.If a lock allows recursion, a thread that has entered the lock in write mode can enter write mode recursively, even if other threads are waiting to enter write mode.

Aplica-se a