Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / C#

Channel — trasferimento asincrono di dati tra produttore e consumatore

System.Threading.Channels.Channel crea canali che collegano produttori e consumatori. Un canale limitato può attendere in modo asincrono che si liberi spazio, mentre uno illimitato non impone un limite al numero di elementi. Le opzioni descrivono anche le garanzie sulle operazioni concorrenti di lettura e scrittura.

Versione: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification

Sintassi

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 è una classe factory statica, mentre Channel<T> espone Writer e Reader. Channel.CreateBounded<T> e Channel.CreateUnbounded<T> creano code FIFO per il trasferimento asincrono dei dati. Più consumatori si dividono gli elementi: un canale non invia ogni elemento a tutti. Le API trattate qui sono disponibili in .NET 10; l’esempio non richiede funzionalità del linguaggio in anteprima.

BoundedChannelOptions specifica la capacità del canale e il suo comportamento quando non può accettare un altro elemento. In .NET 10, la capacità può essere positiva o pari a 0. Con una capacità pari a 0, il canale non ha un buffer: una scrittura e una lettura devono incontrarsi perché l’elemento venga trasferito direttamente. Nella modalità predefinita BoundedChannelFullMode.Wait, se una scrittura non può procedere subito, WriteAsync attende in modo asincrono che si liberi spazio nel buffer oppure, se il canale non ha un buffer, che sia disponibile una lettura corrispondente. Non blocca il thread; nella stessa situazione TryWrite restituisce false. Si crea così una contropressione che rallenta il produttore. Le altre modalità per canali pieni possono scartare elementi.

UnboundedChannelOptions configura un canale senza un limite fisso di capacità, creato tramite Channel.CreateUnbounded<T>. Le scritture non aspettano che si liberi spazio, ma se il produttore supera continuamente il consumatore, il buffer può usare quantità sempre maggiori di memoria. Entrambi i tipi di opzioni ereditano ChannelOptions.SingleReader e ChannelOptions.SingleWriter. Impostare uno dei due su true garantisce al massimo un’operazione di lettura o scrittura alla volta e consente ottimizzazioni; non è un blocco che impone tale regola. In assenza di questa garanzia, lascia il valore false.

Al termine delle scritture, chiama Writer.Complete(): ReadAllAsync() svuota il buffer e termina l’iterazione. Se ci sono più produttori, completa il canale solo dopo che tutti hanno finito di scrivere. Un errore può essere passato tramite TryComplete(error) e un token di annullamento può interrompere l’attesa. Esegui produttore e consumatore in contemporanea; attendere la fine del produttore prima di iniziare a leggere può causare un deadlock se il canale in modalità Wait è pieno.

Esempi

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;
    }
}

Risultato

1
2
3

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti