Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / C#

Monitor — bloquear y esperar una condición

System.Threading.Monitor combina la exclusión mutua con la espera de cambios en un estado compartido. Enter y Exit gestionan el bloqueo, TryEnter puede limitar la espera para adquirirlo y Wait, Pulse y PulseAll coordinan los hilos.

Versión: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification

Sintaxis

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 el estado compartido mediante un bloqueo asociado a un objeto concreto. Todos los hilos que colaboran deben usar la misma instancia, preferiblemente un readonly object privado. Evita las cadenas y los valores que puedan sufrir boxing. Estas API están disponibles en .NET 10; el ejemplo no requiere características del lenguaje en preview.

Monitor.Enter espera a adquirir el bloqueo y Monitor.Exit lo libera. El bloqueo es reentrante: el mismo hilo puede entrar varias veces, pero necesita el mismo número de llamadas a Exit. Libéralo en finally; con Enter(gate, ref lockTaken), inicializa lockTaken = false y llama a Exit solo después de adquirirlo. Monitor.TryEnter intenta adquirirlo sin esperar o con un tiempo límite; la sobrecarga que devuelve bool indica si lo consigue.

Monitor.Wait requiere que el hilo posea el bloqueo: lo libera y bloquea el hilo; antes de volver normalmente, lo adquiere de nuevo. Monitor.Pulse notifica a un hilo en espera, mientras que Monitor.PulseAll notifica a todos. La notificación no libera el bloqueo ni lo transfiere inmediatamente. Las señales no se guardan si nadie está esperando. Comprueba la condición con while, no con if: el estado puede haber cambiado cuando se vuelva a adquirir el bloqueo. El tiempo límite de Wait no limita el tiempo necesario para volver a adquirirlo.

Llamar a Wait, Pulse, PulseAll o Exit sin poseer el bloqueo correspondiente produce SynchronizationLockException. La propiedad de un monitor está vinculada al hilo; no la mantengas a través de await. Para un object normal, la instrucción lock usa un monitor. Desde C# 13, lock aplicado a una expresión de tipo System.Threading.Lock usa otro mecanismo: no lo combines con Monitor.Wait ni con las notificaciones de monitor.

Ejemplos

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

El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.

Fuentes