Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / C#

Channel — asinhroni prenos podatkov med producentom in porabnikom

System.Threading.Channels.Channel ustvarja kanale, ki povezujejo producente in porabnike. Omejeni kanal lahko asinhrono čaka na prostor, neomejeni pa ne določa omejitve števila elementov. Možnosti opisujejo tudi zagotovila glede sočasnih branj in zapisov.

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

Sintaksa

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 statični tovarniški razred, medtem ko Channel<T> izpostavlja Writer in Reader. Channel.CreateBounded<T> in Channel.CreateUnbounded<T> ustvarita vrste FIFO za asinhroni prenos podatkov. Več porabnikov si elemente razdeli: kanal ne pošlje vsakega elementa vsem. Obravnavani API-ji so na voljo v .NET 10; primer ne zahteva jezikovnih funkcij v predogledni različici.

BoundedChannelOptions določa kapaciteto kanala in njegovo vedenje, ko ne more sprejeti naslednjega elementa. V .NET 10 je kapaciteta lahko pozitivna ali enaka 0. Pri kapaciteti 0 kanal nima medpomnilnika: zapis se mora ujemati z branjem, da se element prenese neposredno. Če zapisa ni mogoče izvesti takoj, v privzetem načinu BoundedChannelFullMode.Wait metoda WriteAsync asinhrono čaka na prostor v medpomnilniku ali, pri kanalu brez medpomnilnika, na ustrezno branje. Pri tem ne blokira niti; v enaki situaciji TryWrite vrne false. Tako nastane povratni pritisk, ki upočasni producenta. Drugi načini za poln kanal lahko elemente zavržejo.

UnboundedChannelOptions konfigurira kanal brez fiksne omejitve zmogljivosti, ustvarjen z Channel.CreateUnbounded<T>. Zapisom ni treba čakati na prostor, vendar lahko medpomnilnik porablja vse več pomnilnika, če producent stalno prehiteva porabnika. Oba tipa možnosti podedujeta ChannelOptions.SingleReader in ChannelOptions.SingleWriter. Vrednost true zagotavlja največ eno bralno ali zapisovalno operacijo hkrati in omogoča optimizacije; ne gre za zaklep, ki bi to pravilo uveljavljal. Če takega zagotovila ne morete dati, pustite vrednost false.

Ko so zapisi končani, pokličite Writer.Complete(): ReadAllAsync() izprazni medpomnilnik in konča iteracijo. Če je producentov več, kanal dokončajte šele, ko končajo vsi zapisovalci. Napako lahko posredujete prek TryComplete(error), žeton za preklic pa lahko prekine čakanje. Producenta in porabnika zaženite sočasno; čakanje na konec producenta pred začetkom branja lahko povzroči zastoj, če se kanal v načinu Wait napolni.

Primeri

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;
    }
}

Rezultat

1
2
3

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri