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
- 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