CKTIS / C#
BoundedChannelOptions a BoundedChannelFullMode.Wait
Nastavte kapacitu bufferu a zjistěte, proč u plného kanálu `TryWrite` ihned vrátí `false`, zatímco `WriteAsync` asynchronně čeká na volné místo.
Verze: C# 12 and .NET 8; later runtimes may add compatible features
Syntaxe
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 předejte BoundedChannelOptions z oboru názvů System.Threading.Channels metodě Channel.CreateBounded<T>(options). Kladná hodnota Capacity omezuje počet položek v bufferu, nikoli položky, které spotřebitelé již zpracovávají, ani počet čekajících zápisů. Jednodušší přetížení Channel.CreateBounded<T>(capacity) také používá režim Wait.
FullMode určuje, co se stane při pokusu o zápis do plného bufferu. Výchozí režim BoundedChannelFullMode.Wait kvůli zaplnění žádné položky nezahazuje. TryWrite(item) vrátí true, pokud se zápis podaří, nebo ihned false, je-li kanál plný nebo je-li zápis do něj ukončen. Po výsledku false nezůstane žádný čekající zápis.
WriteAsync(item, cancellationToken) vrací ValueTask: může skončit ihned, ale při plném bufferu čeká na místo bez blokování vlákna. Před vytvořením další položky použijte await, aby pomalý spotřebitel mohl zpomalit producenta (backpressure). Zrušení může přerušit čekající zápis výjimkou OperationCanceledException, řádné ukončení zápisu výjimkou ChannelClosedException. Úspěch znamená, že položka byla přijata, nikoli zpracována.
WaitToWriteAsync signalizuje možnost zápisu, ale místo nerezervuje. Při více producentech ho může obsadit jiný producent. Pokud TryWrite selže, počkejte znovu, je-li zápis stále možný. Po řádném ukončení pomocí Complete() může spotřebitel položky z bufferu ještě dočíst.
Pří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ýsledek
TryWrite(99): False WriteAsync(2) completed: False Read: 1 Read: 2
`1` zaplní buffer. Pokus zapsat `99` selže a zápis `2` čeká. Přečtení `1` uvolní místo, zápis `2` se dokončí a po `Complete()` přečte `ReadAllAsync()` hodnotu `2`.
Související lekce
- C# · Lekce 46 · Pokročilá · Verze: 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