CKTIS / C#
BoundedChannelOptions a BoundedChannelFullMode.Wait
Nastavte kapacitu medzipamäte a zistite, prečo pri plnom kanáli `TryWrite` ihneď vráti `false`, zatiaľ čo `WriteAsync` asynchrónne čaká na miesto.
Verzia: C# 12 and .NET 8; later runtimes may add compatible features
Syntax
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 a .NET 8 odovzdajte BoundedChannelOptions z priestoru názvov System.Threading.Channels metóde Channel.CreateBounded<T>(options). Kladná hodnota Capacity obmedzuje počet položiek v medzipamäti, nie počet položiek, ktoré spotrebitelia už spracúvajú, ani počet čakajúcich zápisov. Jednoduchšie preťaženie Channel.CreateBounded<T>(capacity) tiež používa režim Wait.
FullMode určuje, čo sa stane pri pokuse o zápis do plnej medzipamäte. Predvolený režim BoundedChannelFullMode.Wait pri zaplnení nezahadzuje položky. TryWrite(item) vráti true, ak sa zápis podarí, alebo okamžite false, ak je kanál plný alebo je zápis doň ukončený. Po výsledku false nezostane žiadny čakajúci zápis.
WriteAsync(item, cancellationToken) vracia ValueTask: zápis sa môže dokončiť ihneď, ale pri plnej medzipamäti čaká na miesto bez blokovania vlákna. Pred vytvorením ďalšej položky použite await, aby pomalý spotrebiteľ mohol spomaliť producenta (backpressure). Zrušenie môže prerušiť čakajúci zápis výnimkou OperationCanceledException, riadne ukončenie zápisu výnimkou ChannelClosedException. Úspech znamená, že položka bola prijatá, nie spracovaná.
WaitToWriteAsync signalizuje možnosť zápisu, ale miesto nerezervuje. Pri viacerých producentoch ho môže obsadiť niekto iný. Ak TryWrite zlyhá, počkajte znova, ak je zápis ešte možný. Po riadnom ukončení pomocou Complete() môže spotrebiteľ zvyšné položky ešte prečítať.
Príklady
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}");
}Výsledok
TryWrite(99): False WriteAsync(2) completed: False Read: 1 Read: 2
`1` zaplní medzipamäť. Pokus zapísať `99` zlyhá a zápis `2` čaká. Prečítanie `1` uvoľní miesto, zápis `2` sa dokončí a `ReadAllAsync()` po `Complete()` prečíta hodnotu `2`.
Súvisiace lekcie
- C# · Lekcia 46 · Pokročilá · Verzia: 3
Zdroje
- 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