База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / C#

Channel — асинхронно предаване на данни между производител и потребител

System.Threading.Channels.Channel създава канали, които свързват производители и потребители. Ограниченият канал може асинхронно да изчаква свободно място, докато неограниченият не задава лимит за броя елементи. Опциите описват и гаранциите за едновременни операции на четене и запис.

Версия: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification

Синтаксис

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 е статичен фабричен клас, а Channel<T> предоставя Writer и Reader. Channel.CreateBounded<T> и Channel.CreateUnbounded<T> създават FIFO опашки за асинхронно предаване на данни. Няколко потребители си разпределят елементите: каналът не изпраща всеки елемент до всички. Разглежданите API са налични в .NET 10; примерът не изисква езикови функции в предварителна версия.

BoundedChannelOptions задава капацитета на канала и поведението му, когато не може да приеме още един елемент. В .NET 10 капацитетът може да е положителен или равен на 0. При капацитет 0 каналът няма буфер: операция за запис трябва да се съчетае с операция за четене, за да се предаде елементът директно. В режима по подразбиране BoundedChannelFullMode.Wait, ако записът не може да се извърши веднага, WriteAsync изчаква асинхронно свободно място в буфера или, при канал без буфер, съответстваща операция за четене. Нишката не се блокира; в същата ситуация TryWrite връща false. Така се осигурява обратен натиск, който забавя производителя. Другите режими за пълен канал могат да изхвърлят елементи.

UnboundedChannelOptions конфигурира канал без фиксирано ограничение на капацитета, създаден чрез Channel.CreateUnbounded<T>. Записите не чакат свободно място, но ако производителят постоянно изпреварва потребителя, буферът може да използва все повече памет. И двата типа опции наследяват ChannelOptions.SingleReader и ChannelOptions.SingleWriter. Стойността true гарантира най-много една операция на четене или запис едновременно и позволява оптимизации; тя не е заключване, което налага това правило. Ако не можете да дадете такава гаранция, оставете стойността false.

След като записите приключат, извикайте Writer.Complete(): ReadAllAsync() изпразва буфера и завършва итерацията. При няколко производители завършете канала едва след като всички приключат с писането. Грешка може да се предаде чрез TryComplete(error), а токен за отменяне може да прекъсне изчакването. Стартирайте производителя и потребителя едновременно; ако изчакате производителят да приключи, преди да започнете да четете, пълен канал в режим Wait може да доведе до блокиране.

Примери

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

Резултат

1
2
3

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници