Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C#

Monitor — blokowanie i oczekiwanie na warunek

System.Threading.Monitor łączy wzajemne wykluczanie z oczekiwaniem na zmianę współdzielonego stanu. Enter i Exit zarządzają blokadą, TryEnter pozwala ograniczyć oczekiwanie, a Wait, Pulse i PulseAll umożliwiają koordynację wątków.

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

Składnia

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 chroni współdzielony stan za pomocą blokady przypisanej do konkretnego obiektu. Wszystkie współpracujące wątki muszą używać tej samej instancji, najlepiej prywatnego readonly object. Nie używaj ciągów znaków ani wartości podlegających boxingowi. Te interfejsy API są dostępne w .NET 10; przykład nie wymaga funkcji języka w wersji preview.

Monitor.Enter czeka na uzyskanie blokady, a Monitor.Exit ją zwalnia. Blokada jest reentrantna: ten sam wątek może wejść wielokrotnie, ale potrzebuje tylu samo wywołań Exit. Zwalniaj ją w finally; przy przeciążeniu Enter(gate, ref lockTaken) ustaw początkowo lockTaken = false i wywołaj Exit tylko po uzyskaniu blokady. Monitor.TryEnter próbuje wejść bez czekania lub z limitem czasu; wariant zwracający bool informuje o powodzeniu.

Monitor.Wait wymaga posiadania blokady: zwalnia ją i usypia wątek, a przed zwykłym powrotem ponownie ją uzyskuje. Monitor.Pulse powiadamia jeden oczekujący wątek, a Monitor.PulseAll wszystkie. Powiadomienie nie zwalnia blokady ani nie przekazuje jej natychmiast. Sygnały nie są zapamiętywane, gdy nikt nie czeka. Sprawdzaj warunek w while, nie w if: po odzyskaniu blokady stan mógł się zmienić. Limit czasu Wait nie ogranicza czasu potrzebnego na ponowne uzyskanie blokady.

Wait, Pulse, PulseAll i Exit bez posiadania odpowiedniej blokady zgłaszają SynchronizationLockException. Monitor jest związany z wątkiem; nie przenoś jego własności przez await. Dla zwykłego object instrukcja lock używa monitora. Od C# 13 lock na wyrażeniu typu System.Threading.Lock korzysta z innego mechanizmu: nie łącz go z Monitor.Wait ani sygnałami monitora.

Przykłady

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

Wynik

42

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła