KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / C#

Monitor — vergrendelen en op een voorwaarde wachten

System.Threading.Monitor combineert wederzijdse uitsluiting met wachten tot een gedeelde toestand verandert. Enter en Exit beheren de vergrendeling, TryEnter kan de wachttijd voor het verkrijgen ervan begrenzen, en Wait, Pulse en PulseAll coördineren threads.

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

Syntax

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 beschermt gedeelde toestand met een vergrendeling die aan een bepaald object is gekoppeld. Alle samenwerkende threads moeten dezelfde instantie gebruiken, bij voorkeur een private readonly object. Gebruik geen tekenreeksen of waarden die worden geboxed. Deze API’s zijn beschikbaar in .NET 10; het voorbeeld vereist geen preview-taalfuncties.

Monitor.Enter wacht tot de vergrendeling is verkregen en Monitor.Exit geeft deze vrij. De vergrendeling is reentrant: dezelfde thread kan haar meerdere keren verkrijgen, maar moet dan even vaak Exit aanroepen. Geef haar vrij in finally; initialiseer bij Enter(gate, ref lockTaken) lockTaken = false en roep Exit alleen aan nadat de vergrendeling is verkregen. Monitor.TryEnter probeert de vergrendeling zonder wachten of met een time-out te verkrijgen; de overload die bool retourneert, meldt of dit is gelukt.

Monitor.Wait vereist dat de thread de vergrendeling bezit: de methode geeft haar vrij en blokkeert de thread, en verkrijgt haar opnieuw voordat de methode normaal terugkeert. Monitor.Pulse waarschuwt één wachtende thread; Monitor.PulseAll waarschuwt ze allemaal. Een melding geeft de vergrendeling niet vrij en draagt haar niet onmiddellijk over. Signalen worden niet onthouden als niemand wacht. Controleer de voorwaarde met while, niet met if: de toestand kan veranderd zijn wanneer de vergrendeling opnieuw is verkregen. Een time-out voor Wait begrenst niet de tijd die nodig is om de vergrendeling opnieuw te verkrijgen.

Wait, Pulse, PulseAll of Exit aanroepen zonder de bijbehorende vergrendeling te bezitten, veroorzaakt SynchronizationLockException. Het bezit van een monitor is threadgebonden; neem het niet mee over await. Voor een gewone object gebruikt de lock-instructie een monitor. Vanaf C# 13 gebruikt lock op een expressie van het type System.Threading.Lock een ander mechanisme: combineer dit niet met Monitor.Wait of monitor-meldingen.

Voorbeelden

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

Resultaat

42

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen