Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

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.

Zdroje