CKTIS / C#
Channel — asynchrónne odovzdávanie údajov medzi producentom a konzumentom
System.Threading.Channels.Channel vytvára kanály spájajúce producentov a konzumentov. Obmedzený kanál môže asynchrónne čakať na voľné miesto, kým neobmedzený neurčuje limit počtu položiek. Možnosti opisujú aj záruky pre súbežné operácie čítania a zápisu.
Verzia: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification
Syntax
Channel<T> channel = Channel.CreateBounded<T>(new BoundedChannelOptions(capacity) { FullMode = BoundedChannelFullMode.Wait, SingleReader = true, SingleWriter = true });
Channel<T> unbounded = Channel.CreateUnbounded<T>(new UnboundedChannelOptions());System.Threading.Channels.Channel je statická továrenská trieda, zatiaľ čo Channel<T> sprístupňuje Writer a Reader. Channel.CreateBounded<T> a Channel.CreateUnbounded<T> vytvárajú FIFO fronty na asynchrónne odovzdávanie údajov. Viacerí konzumenti si položky rozdelia: kanál neposiela každú položku všetkým. Opisované API sú dostupné v .NET 10; príklad nevyžaduje jazykové funkcie vo verzii preview.
BoundedChannelOptions určuje kapacitu kanála a jeho správanie, keď nemôže prijať ďalšiu položku. V .NET 10 môže byť kapacita kladná alebo rovná 0. Pri kapacite 0 kanál nemá vyrovnávaciu pamäť: zápis a čítanie sa musia spárovať, aby sa položka odovzdala priamo. Ak zápis nemôže prebehnúť ihneď, v predvolenom režime BoundedChannelFullMode.Wait metóda WriteAsync asynchrónne čaká na miesto vo vyrovnávacej pamäti alebo pri kanáli bez vyrovnávacej pamäte na zodpovedajúce čítanie. Vlákno sa pritom neblokuje; TryWrite v rovnakej situácii vráti hodnotu false. Vzniká tak spätný tlak, ktorý spomaľuje producenta. Ostatné režimy plného kanála môžu položky zahadzovať.
UnboundedChannelOptions konfiguruje kanál bez pevného limitu kapacity, vytvorený pomocou Channel.CreateUnbounded<T>. Zápisy nečakajú na voľné miesto, ale ak producent neustále predbieha konzumenta, vyrovnávacia pamäť môže spotrebúvať čoraz viac pamäte. Oba typy možností dedia ChannelOptions.SingleReader a ChannelOptions.SingleWriter. Hodnota true sľubuje najviac jednu operáciu čítania alebo zápisu naraz a umožňuje optimalizácie; nejde o zámok, ktorý toto pravidlo vynucuje. Ak takú záruku nemáte, ponechajte hodnotu false.
Po dokončení zápisov zavolajte Writer.Complete(): ReadAllAsync() vyprázdni vyrovnávaciu pamäť a ukončí iteráciu. Pri viacerých producentoch dokončite kanál až po skončení všetkých zapisujúcich. Chybu možno odovzdať cez TryComplete(error) a token zrušenia môže prerušiť čakanie. Producenta a konzumenta spustite súbežne; čakanie na dokončenie producenta pred začatím čítania môže pri plnom kanáli v režime Wait spôsobiť uviaznutie.
Príklady
using System;
using System.Threading.Channels;
using System.Threading.Tasks;
Channel<int> channel = Channel.CreateBounded<int>(
new BoundedChannelOptions(1)
{
FullMode = BoundedChannelFullMode.Wait,
SingleReader = true,
SingleWriter = true
});
Task producer = ProduceAsync(channel.Writer);
await foreach (int value in channel.Reader.ReadAllAsync())
{
Console.WriteLine(value);
}
await producer;
static async Task ProduceAsync(ChannelWriter<int> writer)
{
try
{
for (int value = 1; value <= 3; value++)
{
await writer.WriteAsync(value);
}
writer.Complete();
}
catch (Exception error)
{
writer.TryComplete(error);
throw;
}
}Výsledok
1 2 3
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.