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

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.

Fuentes