CKTIS / C#
BoundedChannelOptions in BoundedChannelFullMode.Wait
Nastavite omejitev medpomnilnika in ugotovite, zakaj pri polnem kanalu `TryWrite` takoj vrne `false`, `WriteAsync` pa asinhrono počaka na prostor.
Različica: C# 12 and .NET 8; later runtimes may add compatible features
Sintaksa
using System.Threading.Channels;
var options = new BoundedChannelOptions(capacity: 2)
{
FullMode = BoundedChannelFullMode.Wait
};
Channel<int> channel = Channel.CreateBounded<int>(options);
bool written = channel.Writer.TryWrite(1);
await channel.Writer.WriteAsync(2);V C# 12 in .NET 8 posredujte BoundedChannelOptions iz imenskega prostora System.Threading.Channels metodi Channel.CreateBounded<T>(options). Pozitivna vrednost Capacity omejuje število elementov v medpomnilniku, ne pa števila elementov, ki jih porabniki že obdelujejo, ali števila čakajočih zapisov. Tudi preprostejša preobremenitev Channel.CreateBounded<T>(capacity) uporablja Wait.
FullMode določa, kaj se zgodi pri poskusu pisanja v poln medpomnilnik. Privzeti način BoundedChannelFullMode.Wait zaradi polnega medpomnilnika ne zavrže elementov. TryWrite(item) vrne true, če zapis uspe, ali takoj false, če je kanal poln ali zaprt za pisanje. Po rezultatu false ne ostane noben čakajoč zapis.
WriteAsync(item, cancellationToken) vrne ValueTask: zapis se lahko konča takoj, pri polnem medpomnilniku pa čaka na prostor, ne da bi blokiral nit. Preden ustvarite naslednji element, uporabite await, da lahko počasen porabnik upočasni proizvajalca (backpressure). Preklic lahko prekine čakajoči zapis z izjemo OperationCanceledException, običajen zaključek pisanja pa z izjemo ChannelClosedException. Uspeh pomeni, da je bil element sprejet, ne da je bil obdelan.
WaitToWriteAsync sporoči, da je pisanje mogoče, vendar ne rezervira prostora. Pri več proizvajalcih ga lahko zasede drug proizvajalec. Če TryWrite ne uspe, počakajte znova, če je pisanje še mogoče. Po običajnem zaključku z Complete() lahko porabnik še vedno prebere preostale elemente iz medpomnilnika.
Primeri
using System;
using System.Threading.Channels;
var channel = Channel.CreateBounded<int>(new BoundedChannelOptions(capacity: 1)
{
FullMode = BoundedChannelFullMode.Wait
});
await channel.Writer.WriteAsync(1);
Console.WriteLine($"TryWrite(99): {channel.Writer.TryWrite(99)}");
var pending = channel.Writer.WriteAsync(2);
Console.WriteLine($"WriteAsync(2) completed: {pending.IsCompleted}");
Console.WriteLine($"Read: {await channel.Reader.ReadAsync()}");
await pending;
channel.Writer.Complete();
await foreach (var item in channel.Reader.ReadAllAsync())
{
Console.WriteLine($"Read: {item}");
}Rezultat
TryWrite(99): False WriteAsync(2) completed: False Read: 1 Read: 2
`1` napolni medpomnilnik. Poskus zapisa `99` ne uspe, zapis `2` pa čaka. Branje `1` sprosti prostor, zapis `2` se konča in `ReadAllAsync()` po `Complete()` prebere `2`.
Povezane lekcije
- C# · Lekcija 46 · Napredna · Različica: 3
Viri
- Channels - .NET
- BoundedChannelOptions Class
- BoundedChannelFullMode Enum
- Channel.CreateBounded Method
- ChannelWriter<T>.TryWrite(T) Method
- ChannelWriter<T>.WriteAsync(T, CancellationToken) Method
- ChannelWriter<T>.WaitToWriteAsync(CancellationToken) Method
- ChannelReader<T>.ReadAllAsync(CancellationToken) Method