CKTIS / C#
Monitor — zamykanie a čakanie na podmienku
System.Threading.Monitor spája vzájomné vylúčenie s čakaním na zmenu zdieľaného stavu. Enter a Exit spravujú zámok, TryEnter môže obmedziť čakanie na jeho získanie a Wait, Pulse a PulseAll koordinujú vlákna.
Verzia: .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 chráni zdieľaný stav zámkom priradeným ku konkrétnemu objektu. Všetky spolupracujúce vlákna musia používať tú istú inštanciu, najlepšie súkromný readonly object. Nepoužívajte reťazce ani hodnoty podliehajúce boxing. Tieto rozhrania API sú dostupné v .NET 10; príklad nevyžaduje jazykové funkcie preview.
Monitor.Enter čaká na získanie zámku a Monitor.Exit ho uvoľní. Zámok je reentrantný: to isté vlákno doň môže vstúpiť opakovane, ale potom musí zavolať Exit rovnaký počet ráz. Uvoľňujte ho v finally; pri použití Enter(gate, ref lockTaken) najprv nastavte lockTaken = false a Exit zavolajte iba po získaní zámku. Monitor.TryEnter sa pokúsi zámok získať bez čakania alebo s časovým limitom; preťaženie vracajúce bool oznámi, či sa to podarilo.
Monitor.Wait vyžaduje, aby vlákno vlastnilo zámok: uvoľní ho a zablokuje vlákno, pred bežným návratom ho však znovu získa. Monitor.Pulse upozorní jedno čakajúce vlákno, zatiaľ čo Monitor.PulseAll upozorní všetky. Upozornenie zámok neuvoľní ani ho okamžite neodovzdá. Ak nikto nečaká, signály sa neukladajú. Podmienku kontrolujte pomocou while, nie if: kým sa zámok znovu získa, stav sa mohol zmeniť. Časový limit Wait neobmedzuje čas potrebný na opätovné získanie zámku.
Volanie Wait, Pulse, PulseAll alebo Exit bez vlastníctva príslušného zámku vyvolá SynchronizationLockException. Vlastníctvo monitora je viazané na vlákno; neprenášajte ho cez await. Pri bežnom object používa príkaz lock monitor. Od C# 13 používa lock nad výrazom typu System.Threading.Lock iný mechanizmus: nekombinujte ho s Monitor.Wait ani s upozorneniami monitora.
Prí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ýsledok
42
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.
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