Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / C#

Monitor — verrouiller et attendre une condition

System.Threading.Monitor associe l’exclusion mutuelle à l’attente d’un changement d’état partagé. Enter et Exit gèrent le verrou, TryEnter peut limiter l’attente de son acquisition, et Wait, Pulse et PulseAll coordonnent les threads.

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

Syntaxe

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 protège l’état partagé au moyen d’un verrou associé à un objet précis. Tous les threads qui coopèrent doivent utiliser la même instance, de préférence un readonly object privé. Évitez les chaînes de caractères et les valeurs susceptibles d’être boxées. Ces API sont disponibles dans .NET 10 ; l’exemple ne nécessite aucune fonctionnalité du langage en preview.

Monitor.Enter attend l’acquisition du verrou et Monitor.Exit le libère. Le verrou est réentrant : un même thread peut l’acquérir plusieurs fois, mais doit alors appeler Exit autant de fois. Libérez-le dans finally ; avec Enter(gate, ref lockTaken), initialisez lockTaken = false et appelez Exit uniquement après l’acquisition. Monitor.TryEnter tente l’acquisition sans attendre ou avec un délai maximal ; la surcharge qui renvoie un bool indique si elle a réussi.

Monitor.Wait exige que le thread possède le verrou : il le libère et bloque le thread, puis réacquiert le verrou avant de retourner normalement. Monitor.Pulse avertit un thread en attente, tandis que Monitor.PulseAll les avertit tous. Une notification ne libère pas le verrou et ne le transfère pas immédiatement. Les signaux ne sont pas mémorisés si personne n’attend. Vérifiez la condition avec while, et non avec if : l’état peut avoir changé lorsque le verrou est réacquis. Le délai maximal de Wait ne limite pas le temps nécessaire pour réacquérir le verrou.

Appeler Wait, Pulse, PulseAll ou Exit sans posséder le verrou correspondant déclenche SynchronizationLockException. La possession d’un monitor est liée au thread ; ne la conservez pas au-delà d’un await. Pour un object ordinaire, l’instruction lock utilise un monitor. Depuis C# 13, lock appliqué à une expression de type System.Threading.Lock utilise un autre mécanisme : ne le combinez pas avec Monitor.Wait ni avec les notifications de monitor.

Exemples

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();
    }
}

Résultat

42

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources