Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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