CKTIS / C#
Channel — asinkroni prijenos podataka između proizvođača i potrošača
System.Threading.Channels.Channel stvara kanale koji povezuju proizvođače i potrošače. Ograničeni kanal može asinkrono čekati na slobodan prostor, dok neograničeni ne postavlja ograničenje broja stavki. Mogućnosti opisuju i jamstva za istodobne operacije čitanja i pisanja.
Verzija: .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 statička je tvornička klasa, dok Channel<T> izlaže Writer i Reader. Channel.CreateBounded<T> i Channel.CreateUnbounded<T> stvaraju FIFO redove za asinkroni prijenos podataka. Više potrošača dijeli stavke među sobom: kanal ne šalje svaku stavku svima. Ovdje opisani API-ji dostupni su u .NET 10; primjer ne zahtijeva jezične značajke u pretpreglednoj verziji.
BoundedChannelOptions određuje kapacitet kanala i njegovo ponašanje kad ne može prihvatiti još jednu stavku. U .NET 10 kapacitet može biti pozitivan ili jednak 0. Pri kapacitetu 0 kanal nema međuspremnik: pisanje i čitanje moraju se upariti kako bi se stavka prenijela izravno. U zadanom načinu BoundedChannelFullMode.Wait, ako pisanje ne može odmah krenuti, WriteAsync asinkrono čeka slobodno mjesto u međuspremniku ili, ako kanal nema međuspremnik, odgovarajuće čitanje. Pritom ne blokira dretvu; u istoj situaciji TryWrite vraća false. Time se stvara povratni pritisak koji usporava proizvođača. Ostali načini za puni kanal mogu odbacivati stavke.
UnboundedChannelOptions konfigurira kanal bez fiksnog ograničenja kapaciteta, stvoren pomoću Channel.CreateUnbounded<T>. Pisanja ne čekaju slobodan prostor, no ako proizvođač stalno prestiže potrošača, međuspremnik može trošiti sve više memorije. Oba tipa mogućnosti nasljeđuju ChannelOptions.SingleReader i ChannelOptions.SingleWriter. Vrijednost true obećava najviše jednu operaciju čitanja ili pisanja istodobno i omogućuje optimizacije; to nije zaključavanje koje provodi to pravilo. Ako ne možete dati takvo jamstvo, ostavite vrijednost false.
Nakon završetka pisanja pozovite Writer.Complete(): ReadAllAsync() prazni međuspremnik i završava iteraciju. Ako postoji više proizvođača, dovršite kanal tek nakon što svi završe s pisanjem. Pogrešku možete proslijediti putem TryComplete(error), a token za otkazivanje može prekinuti čekanje. Pokrenite proizvođača i potrošača istodobno; čekanje da proizvođač završi prije početka čitanja može uzrokovati zastoj ako se kanal u načinu Wait napuni.
Primjeri
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
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.