Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / C#

BoundedChannelOptions i BoundedChannelFullMode.Wait

Postavite ograničenje međuspremnika i saznajte zašto, kada je kanal pun, `TryWrite` odmah vraća `false`, dok `WriteAsync` asinkrono čeka slobodno mjesto.

Verzija: C# 12 and .NET 8; later runtimes may add compatible features

Sintaksa

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

U C# 12 i .NET 8 proslijedite BoundedChannelOptions iz imenskog prostora System.Threading.Channels metodi Channel.CreateBounded<T>(options). Pozitivan Capacity ograničava broj elemenata u međuspremniku, a ne broj elemenata koje potrošači već obrađuju ni broj upisa na čekanju. Jednostavnija preopterećena metoda Channel.CreateBounded<T>(capacity) također koristi Wait.

FullMode određuje što se događa pri pokušaju upisa u pun međuspremnik. Zadani način rada BoundedChannelFullMode.Wait ne odbacuje elemente zbog popunjenosti. TryWrite(item) vraća true ako upis uspije ili odmah false ako je kanal pun ili je upis u kanal završen. Nakon rezultata false nijedan upis ne ostaje na čekanju.

WriteAsync(item, cancellationToken) vraća ValueTask: može završiti odmah, ali kad je međuspremnik pun, čeka na mjesto bez blokiranja dretve. Upotrijebite await prije stvaranja sljedećeg elementa kako bi spor potrošač mogao usporiti proizvođača (backpressure). Otkazivanje može prekinuti upis na čekanju iznimkom OperationCanceledException, a redoviti završetak upisivanja iznimkom ChannelClosedException. Uspjeh znači da je element prihvaćen, ne i obrađen.

WaitToWriteAsync signalizira mogućnost upisa, ali ne rezervira mjesto. Ako ima više proizvođača, drugi ga može zauzeti. Ako TryWrite ne uspije, ponovno pričekajte ako je upis još moguć. Nakon redovitog završetka pomoću Complete() potrošač još može pročitati preostale elemente iz međuspremnika.

Primjeri

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

Rezultat

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

`1` popunjava međuspremnik. Pokušaj upisa `99` ne uspijeva, a upis `2` ostaje na čekanju. Čitanje `1` oslobađa mjesto, upis `2` završava, a `ReadAllAsync()` čita `2` nakon `Complete()`.

Povezane lekcije

  • C# · Lekcija 46 · Napredno · Verzija: 3

Izvori