CKTIS / C#
Channel: transferencia asíncrona de datos entre productor y consumidor
System.Threading.Channels.Channel crea canales que conectan productores y consumidores. Un canal acotado puede esperar de forma asíncrona a que haya espacio, mientras que uno no acotado no impone un límite al número de elementos. Las opciones también describen garantías sobre las operaciones simultáneas de lectura y escritura.
Versión: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification
Sintaxis
Channel<T> channel = Channel.CreateBounded<T>(new BoundedChannelOptions(capacity) { FullMode = BoundedChannelFullMode.Wait, SingleReader = true, SingleWriter = true });
Channel<T> unbounded = Channel.CreateUnbounded<T>(new UnboundedChannelOptions());System.Threading.Channels.Channel es una clase factoría estática, mientras que Channel<T> expone Writer y Reader. Channel.CreateBounded<T> y Channel.CreateUnbounded<T> crean colas FIFO para transferir datos de forma asíncrona. Si hay varios consumidores, se reparten los elementos: un canal no difunde cada elemento a todos. Las API tratadas aquí están disponibles en .NET 10; el ejemplo no requiere características del lenguaje en versión preliminar.
BoundedChannelOptions especifica la capacidad del canal y su comportamiento cuando no puede aceptar otro elemento. En .NET 10, la capacidad puede ser positiva o igual a 0. Con una capacidad de 0, el canal no tiene búfer: una escritura y una lectura deben emparejarse para transferir el elemento directamente. En el modo predeterminado BoundedChannelFullMode.Wait, si una escritura no puede realizarse de inmediato, WriteAsync espera de forma asíncrona a que haya espacio en el búfer o, si el canal no tiene búfer, a que haya una lectura correspondiente. No bloquea ningún subproceso; en la misma situación, TryWrite devuelve false. Esto proporciona contrapresión y ralentiza al productor. Los demás modos para canales llenos pueden descartar elementos.
UnboundedChannelOptions configura un canal sin un límite fijo de capacidad, creado mediante Channel.CreateUnbounded<T>. Las escrituras no esperan a que haya espacio, pero si el productor supera continuamente al consumidor, el búfer puede consumir cada vez más memoria. Ambos tipos de opciones heredan ChannelOptions.SingleReader y ChannelOptions.SingleWriter. Establecer cualquiera de ellos en true garantiza como máximo una operación de lectura o escritura a la vez y permite optimizaciones; no es un bloqueo que imponga esa regla. Si no puedes ofrecer esa garantía, déjalo en false.
Cuando terminen las escrituras, llama a Writer.Complete(): ReadAllAsync() vacía el búfer y finaliza la iteración. Si hay varios productores, completa el canal solo cuando hayan terminado todos. Puedes pasar un error mediante TryComplete(error), y un token de cancelación permite interrumpir la espera. Ejecuta el productor y el consumidor a la vez; esperar a que termine el productor antes de empezar a leer puede provocar un interbloqueo si el canal está lleno y usa Wait.
Ejemplos
using System;
using System.Threading.Channels;
using System.Threading.Tasks;
Channel<int> channel = Channel.CreateBounded<int>(
new BoundedChannelOptions(1)
{
FullMode = BoundedChannelFullMode.Wait,
SingleReader = true,
SingleWriter = true
});
Task producer = ProduceAsync(channel.Writer);
await foreach (int value in channel.Reader.ReadAllAsync())
{
Console.WriteLine(value);
}
await producer;
static async Task ProduceAsync(ChannelWriter<int> writer)
{
try
{
for (int value = 1; value <= 3; value++)
{
await writer.WriteAsync(value);
}
writer.Complete();
}
catch (Exception error)
{
writer.TryComplete(error);
throw;
}
}Resultado
1 2 3
El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.