Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

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