CKTIS / C#
BoundedChannelOptions en BoundedChannelFullMode.Wait
Stel de bufferlimiet in en ontdek waarom `TryWrite` bij een vol kanaal meteen `false` teruggeeft, terwijl `WriteAsync` asynchroon op ruimte wacht.
Versie: 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);Geef in C# 12 en .NET 8 BoundedChannelOptions uit de naamruimte System.Threading.Channels door aan Channel.CreateBounded<T>(options). Een positieve Capacity begrenst het aantal items in de buffer, niet het aantal items dat consumenten al verwerken of het aantal openstaande schrijfbewerkingen. De eenvoudigere overload Channel.CreateBounded<T>(capacity) gebruikt ook Wait.
FullMode bepaalt wat er gebeurt bij een schrijfpoging met een volle buffer. De standaardmodus BoundedChannelFullMode.Wait gooit geen items weg om ruimtegebrek op te lossen. TryWrite(item) geeft true terug bij succes, of meteen false als het kanaal vol is of gesloten is voor schrijven. Na false blijft er geen schrijfbewerking openstaan.
WriteAsync(item, cancellationToken) retourneert een ValueTask: de bewerking kan direct klaar zijn, maar wacht bij een volle buffer op ruimte zonder een thread te blokkeren. Gebruik await voordat je het volgende item produceert, zodat een trage consument de producent kan afremmen (backpressure). Annulering kan een openstaande schrijfbewerking onderbreken met OperationCanceledException; normale afsluiting van de schrijfkant kan dat doen met ChannelClosedException. Succes betekent dat het item is geaccepteerd, niet dat het is verwerkt.
WaitToWriteAsync signaleert dat schrijven mogelijk is, maar reserveert geen plek. Met meerdere producenten kan een ander de plek innemen. Mislukt TryWrite, wacht dan opnieuw als schrijven nog mogelijk is. Na normale afsluiting met Complete() kan de consument de resterende items uit de buffer lezen.
Voorbeelden
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}");
}Resultaat
TryWrite(99): False WriteAsync(2) completed: False Read: 1 Read: 2
`1` vult de buffer. De poging om `99` te schrijven mislukt en het schrijven van `2` blijft openstaan. Lezen van `1` maakt ruimte vrij, het schrijven van `2` wordt voltooid en `ReadAllAsync()` leest `2` na `Complete()`.
Gerelateerde lessen
- C# · Les 46 · Gevorderd · Versie: 3
Bronnen
- 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