Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / C#

BoundedChannelOptions a BoundedChannelFullMode.Wait

Nastavte kapacitu medzipamäte a zistite, prečo pri plnom kanáli `TryWrite` ihneď vráti `false`, zatiaľ čo `WriteAsync` asynchrónne čaká na miesto.

Verzia: 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);

V C# 12 a .NET 8 odovzdajte BoundedChannelOptions z priestoru názvov System.Threading.Channels metóde Channel.CreateBounded<T>(options). Kladná hodnota Capacity obmedzuje počet položiek v medzipamäti, nie počet položiek, ktoré spotrebitelia už spracúvajú, ani počet čakajúcich zápisov. Jednoduchšie preťaženie Channel.CreateBounded<T>(capacity) tiež používa režim Wait.

FullMode určuje, čo sa stane pri pokuse o zápis do plnej medzipamäte. Predvolený režim BoundedChannelFullMode.Wait pri zaplnení nezahadzuje položky. TryWrite(item) vráti true, ak sa zápis podarí, alebo okamžite false, ak je kanál plný alebo je zápis doň ukončený. Po výsledku false nezostane žiadny čakajúci zápis.

WriteAsync(item, cancellationToken) vracia ValueTask: zápis sa môže dokončiť ihneď, ale pri plnej medzipamäti čaká na miesto bez blokovania vlákna. Pred vytvorením ďalšej položky použite await, aby pomalý spotrebiteľ mohol spomaliť producenta (backpressure). Zrušenie môže prerušiť čakajúci zápis výnimkou OperationCanceledException, riadne ukončenie zápisu výnimkou ChannelClosedException. Úspech znamená, že položka bola prijatá, nie spracovaná.

WaitToWriteAsync signalizuje možnosť zápisu, ale miesto nerezervuje. Pri viacerých producentoch ho môže obsadiť niekto iný. Ak TryWrite zlyhá, počkajte znova, ak je zápis ešte možný. Po riadnom ukončení pomocou Complete() môže spotrebiteľ zvyšné položky ešte prečítať.

Príklady

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

Výsledok

TryWrite(99): False
WriteAsync(2) completed: False
Read: 1
Read: 2

`1` zaplní medzipamäť. Pokus zapísať `99` zlyhá a zápis `2` čaká. Prečítanie `1` uvoľní miesto, zápis `2` sa dokončí a `ReadAllAsync()` po `Complete()` prečíta hodnotu `2`.

Súvisiace lekcie

  • C# · Lekcia 46 · Pokročilá · Verzia: 3

Zdroje