CKTIS / C#
Monitor — zaključavanje i čekanje na uvjet
System.Threading.Monitor objedinjuje međusobno isključivanje i čekanje na promjenu zajedničkog stanja. Enter i Exit upravljaju zaključavanjem, TryEnter može ograničiti čekanje na njegovo preuzimanje, a Wait, Pulse i PulseAll koordiniraju dretve.
Verzija: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification
Sintaksa
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 štiti zajedničko stanje zaključavanjem povezanim s određenim objektom. Sve dretve koje surađuju moraju koristiti istu instancu, po mogućnosti privatni readonly object. Nemojte koristiti nizove znakova ni vrijednosti podložne boxing-u. Ovi su API-ji dostupni u .NET 10; primjer ne zahtijeva jezične značajke preview.
Monitor.Enter čeka da preuzme zaključavanje, a Monitor.Exit ga otpušta. Zaključavanje je reentrantno: ista dretva može ući više puta, ali zatim mora pozvati Exit jednak broj puta. Otpustite ga u finally; uz Enter(gate, ref lockTaken) najprije postavite lockTaken = false i pozovite Exit samo ako je zaključavanje preuzeto. Monitor.TryEnter pokušava ga preuzeti bez čekanja ili uz vremensko ograničenje; preopterećenje koje vraća bool javlja je li uspjelo.
Monitor.Wait zahtijeva da dretva posjeduje zaključavanje: otpušta ga i blokira dretvu, a prije uobičajenog povratka ponovno ga preuzima. Monitor.Pulse obavještava jednu dretvu koja čeka, dok Monitor.PulseAll obavještava sve. Obavijest ne otpušta zaključavanje niti ga odmah prenosi. Signali se ne pamte ako nitko ne čeka. Uvjet provjeravajte pomoću while, a ne if: stanje se moglo promijeniti dok se zaključavanje ponovno ne preuzme. Vremensko ograničenje za Wait ne ograničava vrijeme potrebno za ponovno preuzimanje zaključavanja.
Pozivanje Wait, Pulse, PulseAll ili Exit bez posjedovanja odgovarajućeg zaključavanja uzrokuje SynchronizationLockException. Vlasništvo nad monitorom vezano je uz dretvu; nemojte ga prenositi preko await. Za običan object naredba lock koristi monitor. Od C# 13 lock nad izrazom tipa System.Threading.Lock koristi drukčiji mehanizam: nemojte ga kombinirati s Monitor.Wait ni obavijestima monitora.
Primjeri
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();
}
}Rezultat
42
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.
Izvori
- 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