CKTIS / C#
BoundedChannelOptions и BoundedChannelFullMode.Wait
Задайте капацитета на буфера и вижте защо при пълен канал `TryWrite` веднага връща `false`, а `WriteAsync` изчаква асинхронно да се освободи място.
Версия: C# 12 and .NET 8; later runtimes may add compatible features
Синтаксис
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);В C# 12 и .NET 8 подайте BoundedChannelOptions от пространството от имена System.Threading.Channels на Channel.CreateBounded<T>(options). Положителната стойност на Capacity ограничава броя на елементите в буфера, а не броя на елементите, които потребителите вече обработват, нито броя на чакащите записи. По-простият вариант Channel.CreateBounded<T>(capacity) също използва Wait.
FullMode определя какво става при опит за запис в пълен буфер. Режимът по подразбиране BoundedChannelFullMode.Wait не изхвърля елементи заради запълването. TryWrite(item) връща true при успешен запис или веднага false, ако каналът е пълен или записването е приключило. При резултат false не остава чакащ запис.
WriteAsync(item, cancellationToken) връща ValueTask: записът може да приключи веднага, но при пълен буфер изчаква място, без да блокира нишка. Използвайте await, преди да произведете следващия елемент, за да може бавният потребител да забави производителя (backpressure). Отмяната може да прекъсне чакащ запис с OperationCanceledException, а нормалното приключване на записването — с ChannelClosedException. Успешният запис означава, че елементът е приет, а не че е обработен.
WaitToWriteAsync сигнализира, че е възможен запис, но не резервира място. При няколко производители друг може да го заеме. Ако TryWrite не успее, изчакайте отново, стига записването още да е възможно. След нормално приключване с Complete() потребителят все още може да прочете останалите елементи от буфера.
Примери
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}");
}Резултат
TryWrite(99): False WriteAsync(2) completed: False Read: 1 Read: 2
`1` запълва буфера. Опитът за запис на `99` е неуспешен, а записът на `2` изчаква. Прочитането на `1` освобождава място, записът на `2` приключва и `ReadAllAsync()` прочита `2` след `Complete()`.
Свързани уроци
- C# · Урок 46 · Напреднало · Версия: 3
Източници
- 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