Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

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