Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / C#

Channel — asynchronní předávání dat mezi producentem a konzumentem

System.Threading.Channels.Channel vytváří kanály propojující producenty a konzumenty. Omezený kanál může asynchronně čekat na volné místo, zatímco neomezený nestanovuje limit počtu položek. Možnosti popisují také záruky pro souběžné operace čtení a zápisu.

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

Syntaxe

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ární třída, zatímco Channel<T> zpřístupňuje Writer a Reader. Channel.CreateBounded<T> a Channel.CreateUnbounded<T> vytvářejí fronty FIFO pro asynchronní předávání dat. Více konzumentů si položky rozdělí mezi sebe: kanál neposílá každou položku všem. Popisovaná API jsou dostupná v .NET 10; příklad nevyžaduje jazykové funkce ve verzi preview.

BoundedChannelOptions určuje kapacitu kanálu a jeho chování, když nemůže přijmout další položku. V .NET 10 může být kapacita kladná nebo rovna 0. Při kapacitě 0 nemá kanál vyrovnávací paměť: zápis a čtení se musí spárovat, aby se položka předala přímo. Pokud zápis nemůže proběhnout ihned, ve výchozím režimu BoundedChannelFullMode.Wait metoda WriteAsync asynchronně čeká na místo ve vyrovnávací paměti nebo u kanálu bez vyrovnávací paměti na odpovídající čtení. Vlákno se přitom neblokuje; TryWrite ve stejné situaci vrátí hodnotu false. Tím vzniká zpětný tlak, který zpomaluje producenta. Ostatní režimy plného kanálu mohou položky zahazovat.

UnboundedChannelOptions nastavuje kanál bez pevného limitu kapacity, vytvořený pomocí Channel.CreateUnbounded<T>. Zápisy nečekají na volné místo, ale pokud producent trvale předbíhá konzumenta, může vyrovnávací paměť spotřebovávat stále více paměti. Oba typy možností dědí ChannelOptions.SingleReader a ChannelOptions.SingleWriter. Hodnota true slibuje nejvýše jednu operaci čtení nebo zápisu současně a umožňuje optimalizace; nejde o zámek, který toto pravidlo vynucuje. Bez této záruky ponechte hodnotu false.

Po dokončení zápisů zavolejte Writer.Complete(): ReadAllAsync() vyprázdní vyrovnávací paměť a ukončí iteraci. Při více producentech dokončete kanál až poté, co skončí všichni zapisující. Chybu lze předat přes TryComplete(error) a token zrušení může přerušit čekání. Producenta a konzumenta spusťte souběžně; čekání na dokončení producenta před zahájením čtení může u plného kanálu v režimu Wait způsobit uváznutí.

Pří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ýsledek

1
2
3

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