WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C#

Monitor — Sperren und auf eine Bedingung warten

System.Threading.Monitor verbindet gegenseitigen Ausschluss mit dem Warten auf Änderungen eines gemeinsam genutzten Zustands. Enter und Exit verwalten die Sperre, TryEnter kann die Wartezeit beim Erwerb begrenzen, und Wait, Pulse sowie PulseAll koordinieren Threads.

Version: .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 schützt gemeinsam genutzte Zustände mit einer Sperre, die an ein bestimmtes Objekt gebunden ist. Alle zusammenarbeitenden Threads müssen dieselbe Instanz verwenden, vorzugsweise ein privates readonly object. Verwende keine Zeichenfolgen oder Werte, die geboxt werden. Diese APIs sind in .NET 10 verfügbar; das Beispiel benötigt keine Preview-Sprachfunktionen.

Monitor.Enter wartet, bis die Sperre erworben ist, und Monitor.Exit gibt sie frei. Die Sperre ist reentrant: Derselbe Thread kann sie mehrfach betreten, benötigt dann aber ebenso viele Exit-Aufrufe. Gib sie in finally frei; bei Enter(gate, ref lockTaken) initialisiere lockTaken = false und rufe Exit nur auf, wenn die Sperre erworben wurde. Monitor.TryEnter versucht, die Sperre ohne Wartezeit oder mit einem Timeout zu erwerben; die Überladung mit Rückgabewert bool meldet den Erfolg.

Monitor.Wait setzt voraus, dass der Thread die Sperre besitzt: Es gibt die Sperre frei und blockiert den Thread, erwirbt die Sperre aber vor einer normalen Rückkehr erneut. Monitor.Pulse benachrichtigt einen wartenden Thread, während Monitor.PulseAll alle wartenden Threads benachrichtigt. Eine Benachrichtigung gibt die Sperre nicht frei und überträgt sie auch nicht sofort. Signale werden nicht gespeichert, wenn gerade niemand wartet. Prüfe die Bedingung mit while, nicht mit if: Bis die Sperre erneut erworben wird, kann sich der Zustand geändert haben. Ein Timeout von Wait begrenzt nicht die Zeit, die zum erneuten Erwerb der Sperre benötigt wird.

Ein Aufruf von Wait, Pulse, PulseAll oder Exit ohne Besitz der zugehörigen Sperre löst SynchronizationLockException aus. Der Besitz eines Monitors ist an den Thread gebunden; führe ihn nicht über await hinweg fort. Bei einem gewöhnlichen object verwendet die lock-Anweisung einen Monitor. Seit C# 13 verwendet lock bei einem Ausdruck vom Typ System.Threading.Lock einen anderen Mechanismus: Kombiniere ihn nicht mit Monitor.Wait oder Monitorbenachrichtigungen.

Beispiele

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

Ergebnis

42

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen