CKTIS / C#
Monitor — bloquear e aguardar uma condição
System.Threading.Monitor combina a exclusão mútua com a espera por alterações num estado partilhado. Enter e Exit gerem o bloqueio, TryEnter pode limitar a espera pela sua aquisição e Wait, Pulse e PulseAll coordenam as threads.
Versão: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification
Sintaxe
Monitor.Enter(gate, ref lockTaken);
Monitor.Exit(gate);
bool acquired = Monitor.TryEnter(gate, millisecondsTimeout);
bool signaled = Monitor.Wait(gate);
Monitor.Pulse(gate);
Monitor.PulseAll(gate);System.Threading.Monitor protege o estado partilhado com um bloqueio associado a um objeto específico. Todas as threads que cooperam têm de usar a mesma instância, de preferência um readonly object privado. Evite cadeias de caracteres e valores sujeitos a boxing. Estas APIs estão disponíveis no .NET 10; o exemplo não requer funcionalidades de linguagem em preview.
Monitor.Enter aguarda pela aquisição do bloqueio e Monitor.Exit liberta-o. O bloqueio é reentrante: a mesma thread pode adquiri-lo várias vezes, mas precisa de fazer igual número de chamadas a Exit. Liberte-o em finally; com Enter(gate, ref lockTaken), inicialize lockTaken = false e chame Exit apenas depois de adquirir o bloqueio. Monitor.TryEnter tenta adquiri-lo sem esperar ou com um limite de tempo; a sobrecarga que devolve bool indica se conseguiu.
Monitor.Wait exige que a thread possua o bloqueio: liberta-o e bloqueia a thread, voltando a adquiri-lo antes de regressar normalmente. Monitor.Pulse notifica uma thread à espera, enquanto Monitor.PulseAll notifica todas. A notificação não liberta o bloqueio nem o transfere imediatamente. Os sinais não são guardados quando ninguém está à espera. Verifique a condição com while, não com if: o estado pode ter mudado quando o bloqueio for readquirido. O limite de tempo de Wait não limita o tempo necessário para readquirir o bloqueio.
Chamar Wait, Pulse, PulseAll ou Exit sem possuir o bloqueio correspondente gera SynchronizationLockException. A posse de um monitor está associada à thread; não a mantenha através de await. Para um object normal, a instrução lock usa um monitor. Desde C# 13, lock numa expressão do tipo System.Threading.Lock usa um mecanismo diferente: não o combine com Monitor.Wait ou com notificações do monitor.
Exemplos
using System;
using System.Threading;
internal static class Program
{
private static readonly object gate = new();
private static bool ready;
private static int value;
private static void Main()
{
var consumer = new Thread(() =>
{
bool lockTaken = false;
try
{
Monitor.Enter(gate, ref lockTaken);
while (!ready)
Monitor.Wait(gate);
Console.WriteLine(value);
}
finally
{
if (lockTaken)
Monitor.Exit(gate);
}
});
consumer.Start();
lock (gate)
{
value = 42;
ready = true;
Monitor.PulseAll(gate);
}
consumer.Join();
}
}Resultado
42
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.
Fontes
- Monitor Class (System.Threading)
- Monitor.Enter Method (System.Threading)
- Monitor.TryEnter Method (System.Threading)
- Monitor.Wait Method (System.Threading)
- Monitor.Pulse(Object) Method (System.Threading)
- Monitor.PulseAll(Object) Method (System.Threading)
- The lock statement - ensure exclusive access to a shared resource