CKTIS / C#
BoundedChannelOptions y BoundedChannelFullMode.Wait
Fija el límite del búfer y descubre por qué, cuando el canal está lleno, `TryWrite` devuelve `false` de inmediato, pero `WriteAsync` espera espacio de forma asíncrona.
Versión: C# 12 and .NET 8; later runtimes may add compatible features
Sintaxis
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);En C# 12 y .NET 8, pasa BoundedChannelOptions del espacio de nombres System.Threading.Channels a Channel.CreateBounded<T>(options). Una Capacity positiva limita los elementos almacenados en el búfer, no los que los consumidores ya están procesando ni las escrituras pendientes. La sobrecarga más sencilla, Channel.CreateBounded<T>(capacity), también usa Wait.
FullMode determina qué ocurre al escribir con el búfer lleno. El modo predeterminado, BoundedChannelFullMode.Wait, no descarta elementos para gestionar la saturación. TryWrite(item) devuelve true si la escritura tiene éxito o false de inmediato si el canal está lleno o se ha cerrado para escritura. Un resultado false no deja ninguna escritura pendiente.
WriteAsync(item, cancellationToken) devuelve un ValueTask: puede completarse de inmediato, pero si el búfer está lleno, espera espacio sin bloquear un hilo. Usa await antes de producir el siguiente elemento para que un consumidor lento pueda frenar al productor (contrapresión). La cancelación puede interrumpir una escritura pendiente con OperationCanceledException, y el cierre normal de la escritura con ChannelClosedException. Una escritura correcta indica que el elemento fue aceptado, no que se haya procesado.
WaitToWriteAsync indica que hay una oportunidad de escribir, pero no reserva espacio. Con varios productores, otro puede ocuparlo; si TryWrite falla, vuelve a esperar mientras aún se pueda escribir. Tras el cierre normal con Complete(), el consumidor puede seguir leyendo los elementos del búfer.
Ejemplos
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}");
}Resultado
TryWrite(99): False WriteAsync(2) completed: False Read: 1 Read: 2
`1` llena el búfer. El intento de escribir `99` falla y la escritura de `2` queda pendiente. Leer `1` libera espacio, la escritura de `2` se completa y `ReadAllAsync()` lee `2` después de `Complete()`.
Lecciones relacionadas
- C# · Lección 46 · Avanzado · Versión: 3
Fuentes
- 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