CKTIS / C#
Monitor — zamykání a čekání na podmínku
System.Threading.Monitor spojuje vzájemné vyloučení s čekáním na změnu sdíleného stavu. Enter a Exit spravují zámek, TryEnter může omezit čekání na jeho získání a Wait, Pulse a PulseAll koordinují vlákna.
Verze: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification
Syntaxe
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 chrání sdílený stav zámkem přiřazeným ke konkrétnímu objektu. Všechna spolupracující vlákna musí používat stejnou instanci, nejlépe privátní readonly object. Nepoužívejte řetězce ani hodnoty podléhající boxing. Tato rozhraní API jsou dostupná v .NET 10; příklad nevyžaduje jazykové funkce preview.
Monitor.Enter čeká na získání zámku a Monitor.Exit jej uvolní. Zámek je reentrantní: stejné vlákno do něj může vstoupit opakovaně, ale musí pak zavolat Exit stejný početkrát. Uvolňujte jej v finally; při použití Enter(gate, ref lockTaken) nastavte nejprve lockTaken = false a Exit zavolejte pouze po získání zámku. Monitor.TryEnter se pokusí zámek získat bez čekání nebo s časovým limitem; přetížení vracející bool oznámí, zda uspělo.
Monitor.Wait vyžaduje, aby vlákno zámek vlastnilo: uvolní jej a zablokuje vlákno, před běžným návratem jej ale znovu získá. Monitor.Pulse upozorní jedno čekající vlákno, zatímco Monitor.PulseAll upozorní všechna. Upozornění zámek neuvolní ani jej okamžitě nepředá. Pokud nikdo nečeká, signály se neukládají. Podmínku kontrolujte pomocí while, nikoli if: než se zámek znovu získá, stav se mohl změnit. Časový limit Wait neomezuje dobu potřebnou k opětovnému získání zámku.
Volání Wait, Pulse, PulseAll nebo Exit bez vlastnictví příslušného zámku vyvolá SynchronizationLockException. Vlastnictví monitoru je svázáno s vláknem; nepřenášejte je přes await. Pro běžný object používá příkaz lock monitor. Od C# 13 používá lock nad výrazem typu System.Threading.Lock jiný mechanismus: nekombinujte jej s Monitor.Wait ani s upozorněními monitoru.
Příklady
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();
}
}Výsledek
42
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.
Zdroje
- 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