CKTIS / C#
CancellationTokenSource — demander l’annulation et libérer les ressources
CancellationTokenSource gère l’annulation coopérative au moyen d’un CancellationToken. Cancel demande l’arrêt du travail, tandis que Dispose libère les ressources et n’annule pas les opérations.
Version : .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification
Syntaxe
using var source = new CancellationTokenSource();
CancellationToken token = source.Token;
source.Cancel();
// source.Dispose() is called automatically at the end of the scope.System.Threading.CancellationTokenSource expose, par l’intermédiaire de Token, un jeton transmis aux opérations. Cancel() définit IsCancellationRequested sur true dans chaque copie de ce jeton. L’annulation est coopérative : le code qui reçoit le jeton doit réagir ; la demande ne met pas fin de force à un thread. CancelAfter(...) permet de programmer une demande après un délai donné.
CancellationTokenSource.Dispose() libère les ressources, mais ne demande pas l’annulation et ne remplace pas l’attente de la fin du travail. Le propriétaire de la source doit la libérer lorsqu’il a terminé de l’utiliser, par exemple avec using. Ne réutilisez pas la source ensuite. N’appelez Dispose() qu’une fois toutes les autres opérations sur cette source terminées ; cet appel ne doit pas être concurrent avec elles.
L’exemple net10.0 lit l’état du jeton, appelle Cancel(), puis lit à nouveau cet état. En quittant le bloc using, Dispose() est appelé avant le dernier message. L’absence de minuteries et de tâches en arrière-plan rend l’ordre de sortie déterministe.
Exemples
using System;
using System.Threading;
using (var source = new CancellationTokenSource())
{
CancellationToken token = source.Token;
Console.WriteLine($"Before: {token.IsCancellationRequested}");
source.Cancel();
Console.WriteLine($"After: {token.IsCancellationRequested}");
}
Console.WriteLine("Source disposed.");Résultat
Before: False After: True Source disposed.
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.