CKTIS / C#
Channel — transfert asynchrone de données entre producteur et consommateur
System.Threading.Channels.Channel crée des canaux qui relient producteurs et consommateurs. Un canal borné peut attendre de la place de façon asynchrone, tandis qu’un canal non borné n’impose aucune limite au nombre d’éléments. Les options décrivent aussi les garanties relatives aux lectures et écritures concurrentes.
Version : .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification
Syntaxe
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 est une classe fabrique statique, tandis que Channel<T> expose Writer et Reader. Channel.CreateBounded<T> et Channel.CreateUnbounded<T> créent des files FIFO pour le transfert asynchrone de données. Plusieurs consommateurs se répartissent les éléments : un canal ne diffuse pas chaque élément à tout le monde. Les API présentées ici sont disponibles dans .NET 10 ; l’exemple ne nécessite aucune fonctionnalité de langage en préversion.
BoundedChannelOptions définit la capacité du canal et son comportement lorsqu’il ne peut pas accepter un élément supplémentaire. Dans .NET 10, cette capacité peut être positive ou égale à 0. Avec une capacité de 0, le canal n’a pas de tampon : une écriture doit être mise en correspondance avec une lecture pour que l’élément soit transmis directement. Dans le mode par défaut BoundedChannelFullMode.Wait, si une écriture ne peut pas se faire immédiatement, WriteAsync attend de façon asynchrone qu’une place se libère dans le tampon ou, si le canal n’a pas de tampon, qu’une lecture correspondante se présente. Aucun thread n’est bloqué ; dans la même situation, TryWrite renvoie false. Cela fournit une contre-pression qui ralentit le producteur. Les autres modes de canal plein peuvent supprimer des éléments.
UnboundedChannelOptions configure un canal sans limite de capacité fixe, créé avec Channel.CreateUnbounded<T>. Les écritures n’attendent pas de place, mais si le producteur dépasse continuellement le consommateur, le tampon peut utiliser toujours plus de mémoire. Les deux types d’options héritent de ChannelOptions.SingleReader et ChannelOptions.SingleWriter. La valeur true garantit au plus une opération de lecture ou d’écriture à la fois et permet des optimisations ; ce n’est pas un verrou qui impose cette règle. Sans cette garantie, laissez la valeur à false.
Une fois les écritures terminées, appelez Writer.Complete() : ReadAllAsync() vide le tampon et termine l’itération. Avec plusieurs producteurs, ne terminez le canal qu’une fois toutes les écritures achevées. Une erreur peut être transmise via TryComplete(error), et un jeton d’annulation permet d’interrompre l’attente. Exécutez le producteur et le consommateur de façon concurrente ; attendre la fin du producteur avant de commencer les lectures peut provoquer un interblocage si le canal en mode Wait est plein.
Exemples
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;
}
}Résultat
1 2 3
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.