CKTIS / C#
BoundedChannelOptions und BoundedChannelFullMode.Wait
Lege die Puffergrenze fest und sieh, warum bei vollem Kanal `TryWrite` sofort `false` zurückgibt, während `WriteAsync` asynchron auf Platz wartet.
Version: C# 12 and .NET 8; later runtimes may add compatible features
Syntax
using System.Threading.Channels;
var options = new BoundedChannelOptions(capacity: 2)
{
FullMode = BoundedChannelFullMode.Wait
};
Channel<int> channel = Channel.CreateBounded<int>(options);
bool written = channel.Writer.TryWrite(1);
await channel.Writer.WriteAsync(2);Übergib in C# 12 und .NET 8 BoundedChannelOptions aus System.Threading.Channels an Channel.CreateBounded<T>(options). Eine positive Capacity begrenzt die Zahl der gepufferten Elemente, nicht die Zahl der Elemente, die Konsumenten gerade verarbeiten, und auch nicht die Zahl ausstehender Schreibvorgänge. Auch die einfachere Überladung Channel.CreateBounded<T>(capacity) verwendet Wait.
FullMode legt fest, was beim Schreiben in einen vollen Puffer passiert. Der Standardmodus BoundedChannelFullMode.Wait verwirft keine Elemente wegen eines vollen Puffers. TryWrite(item) gibt bei Erfolg true zurück, bei vollem Kanal oder abgeschlossener Schreibseite sofort false. Nach false bleibt kein Schreibvorgang ausstehend.
WriteAsync(item, cancellationToken) gibt einen ValueTask zurück: Der Vorgang kann sofort enden, wartet bei vollem Puffer aber auf Platz, ohne einen Thread zu blockieren. Warte mit await, bevor du das nächste Element erzeugst, damit ein langsamer Konsument den Produzenten bremsen kann (Backpressure). Ein Abbruch kann einen ausstehenden Schreibvorgang mit OperationCanceledException beenden, der reguläre Abschluss der Schreibseite mit ChannelClosedException. Erfolg bedeutet, dass das Element angenommen, nicht dass es verarbeitet wurde.
WaitToWriteAsync signalisiert eine Schreibmöglichkeit, reserviert aber keinen Platz. Bei mehreren Produzenten kann ein anderer den Platz belegen. Warte nach einem fehlgeschlagenen TryWrite erneut, sofern Schreiben noch möglich ist. Nach regulärem Abschluss mit Complete() kann der Konsument die gepufferten Elemente weiterhin lesen.
Beispiele
using System;
using System.Threading.Channels;
var channel = Channel.CreateBounded<int>(new BoundedChannelOptions(capacity: 1)
{
FullMode = BoundedChannelFullMode.Wait
});
await channel.Writer.WriteAsync(1);
Console.WriteLine($"TryWrite(99): {channel.Writer.TryWrite(99)}");
var pending = channel.Writer.WriteAsync(2);
Console.WriteLine($"WriteAsync(2) completed: {pending.IsCompleted}");
Console.WriteLine($"Read: {await channel.Reader.ReadAsync()}");
await pending;
channel.Writer.Complete();
await foreach (var item in channel.Reader.ReadAllAsync())
{
Console.WriteLine($"Read: {item}");
}Ergebnis
TryWrite(99): False WriteAsync(2) completed: False Read: 1 Read: 2
`1` füllt den Puffer. Der Versuch, `99` zu schreiben, scheitert, und der Schreibvorgang für `2` bleibt ausstehend. Das Lesen von `1` schafft Platz, `2` wird geschrieben, und `ReadAllAsync()` liest `2` nach `Complete()`.
Zugehörige Lektionen
- C# · Lektion 46 · Fortgeschritten · Version: 3
Quellen
- Channels - .NET
- BoundedChannelOptions Class
- BoundedChannelFullMode Enum
- Channel.CreateBounded Method
- ChannelWriter<T>.TryWrite(T) Method
- ChannelWriter<T>.WriteAsync(T, CancellationToken) Method
- ChannelWriter<T>.WaitToWriteAsync(CancellationToken) Method
- ChannelReader<T>.ReadAllAsync(CancellationToken) Method