ReaderWriterLockSlim.EnterWriteLock Metodo

Definizione

Tenta di accedere al blocco in modalità di scrittura.Tries to enter the lock in write mode.

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

Eccezioni

La proprietà RecursionPolicy è NoRecursion e il thread corrente ha già acceduto al blocco in tutte le modalità.The RecursionPolicy property is NoRecursion and the current thread has already entered the lock in any mode.

-oppure--or- Il thread corrente ha acceduto alla modalità di lettura e non possiede già un blocco in scrittura, pertanto il tentativo di accedere al blocco in modalità di scrittura creerebbe la possibilità di un 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.

-oppure--or- Il numero di ricorsione supererebbe la capacità del contatore.The recursion number would exceed the capacity of the counter. Il limite è talmente elevato che le applicazioni non dovrebbero mai raggiungerlo.The limit is so large that applications should never encounter it.

L'oggetto ReaderWriterLockSlim è stato eliminato.The ReaderWriterLockSlim object has been disposed.

Esempi

Nell'esempio seguente viene illustrato come utilizzare il EnterWriteLock metodo per attivare il blocco in modalità scrittura.The following example shows how to use the EnterWriteLock method to enter the lock in write mode. Il metodo illustrato nell'esempio aggiunge una nuova coppia chiave/valore alla cache sincronizzata.The method shown in the example adds a new key/value pair to the synchronized cache. Se la chiave è già presente nella cache, l'eccezione generata dall'Inner Dictionary<TKey,TValue> può terminare il metodo.If the key is already in the cache, the exception thrown by the inner Dictionary<TKey,TValue> is allowed to terminate the method. Un finally blocco viene usato per eseguire il ExitWriteLock metodo, assicurando che il chiamante esca dalla modalità di scrittura.A finally block is used to execute the ExitWriteLock method, ensuring that the caller exits write mode.

Questo codice fa parte di un esempio più ampio fornito per ReaderWriterLockSlim la 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

Commenti

Questo metodo si blocca fino a quando il thread chiamante entra nel blocco e pertanto potrebbe non restituire mai.This method blocks until the calling thread enters the lock, and therefore might never return. Usare il TryEnterWriteLock metodo per bloccare per un intervallo specificato e quindi restituire se il thread chiamante non ha acceduto alla modalità di scrittura durante tale intervallo.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 gli altri thread hanno acceduto al blocco in modalità di lettura, un thread che EnterWriteLock chiama il metodo si blocca fino a quando i thread non hanno terminato la modalità di lettura.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 sono presenti thread in attesa di accedere alla modalità di scrittura, i thread aggiuntivi che tentano di accedere alla modalità di lettura o aggiornabili si bloccano fino a quando tutti i thread in attesa di accedere alla modalità di scrittura sono scaduti o sono stati immessi in modalità di scrittura e quindi sono stati terminati.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.

Nota

Se un blocco consente la ricorsione, un thread che ha attivato il blocco in modalità scrittura può attivare la modalità di scrittura in modo ricorsivo, anche se altri thread sono in attesa di accedere alla modalità di scrittura.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.

Si applica a