CKTIS / C#
Channel – asynchrone Datenübertragung zwischen Producer und Consumer
System.Threading.Channels.Channel erstellt Channels, die Producer und Consumer verbinden. Ein begrenzter Channel kann asynchron auf freien Platz warten, während ein unbegrenzter keine Elementzahl festlegt. Optionen beschreiben außerdem Garantien für gleichzeitige Lese- und Schreibvorgänge.
Version: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification
Syntax
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 ist eine statische Factory-Klasse, während Channel<T> Writer und Reader bereitstellt. Channel.CreateBounded<T> und Channel.CreateUnbounded<T> erstellen FIFO-Warteschlangen für die asynchrone Datenübertragung. Mehrere Consumer teilen die Elemente untereinander auf: Ein Channel sendet nicht jedes Element an alle. Die hier behandelten APIs sind in .NET 10 verfügbar; das Beispiel benötigt keine Preview-Sprachfunktionen.
BoundedChannelOptions legt die Kapazität des Channels und sein Verhalten fest, wenn er kein weiteres Element aufnehmen kann. In .NET 10 kann die Kapazität positiv oder 0 sein. Bei einer Kapazität von 0 hat der Channel keinen Puffer: Ein Schreib- und ein Lesevorgang müssen zusammenkommen, damit das Element direkt übergeben wird. Kann ein Schreibvorgang nicht sofort ausgeführt werden, wartet WriteAsync im Standardmodus BoundedChannelFullMode.Wait asynchron auf freien Pufferplatz oder bei einem Channel ohne Puffer auf einen passenden Lesevorgang. Dabei wird kein Thread blockiert; TryWrite gibt in derselben Situation false zurück. Das sorgt für Backpressure und verlangsamt den Producer. Die anderen Modi für volle Channels können Elemente verwerfen.
UnboundedChannelOptions konfiguriert einen Channel ohne feste Kapazitätsgrenze, der mit Channel.CreateUnbounded<T> erstellt wird. Schreibvorgänge warten nicht auf freien Platz. Wenn der Producer den Consumer jedoch ständig überholt, kann der Puffer immer mehr Speicher belegen. Beide Optionstypen erben ChannelOptions.SingleReader und ChannelOptions.SingleWriter. Der Wert true verspricht höchstens einen Lese- oder Schreibvorgang gleichzeitig und ermöglicht Optimierungen; er ist keine Sperre, die diese Regel erzwingt. Ohne diese Garantie sollte der Wert false bleiben.
Rufe nach dem Schreiben Writer.Complete() auf: ReadAllAsync() leert den Puffer und beendet die Iteration. Bei mehreren Producern darf der Channel erst geschlossen werden, wenn alle Schreibvorgänge abgeschlossen sind. Ein Fehler kann über TryComplete(error) übergeben werden; ein Abbruchtoken kann das Warten unterbrechen. Führe Producer und Consumer gleichzeitig aus. Wartest du mit dem Lesen, bis der Producer abgeschlossen ist, kann ein voller Channel mit Wait in einen Deadlock geraten.
Beispiele
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;
}
}Ergebnis
1 2 3
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.