CKTIS / C#
CancellationTokenSource — annulering aanvragen en resources vrijgeven
CancellationTokenSource beheert coöperatieve annulering via een CancellationToken. Cancel vraagt om het werk te stoppen, terwijl Dispose resources vrijgeeft en bewerkingen niet annuleert.
Versie: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification
Syntax
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 stelt via Token een token beschikbaar dat aan bewerkingen wordt doorgegeven. Cancel() stelt IsCancellationRequested in elke kopie van dat token in op true. Annulering is coöperatief: de code die het token ontvangt, moet reageren; het verzoek beëindigt een thread niet met geweld. Met CancelAfter(...) kun je een verzoek na een bepaalde vertraging plannen.
CancellationTokenSource.Dispose() geeft resources vrij, maar vraagt geen annulering aan en vervangt niet het wachten tot het werk klaar is. De eigenaar van de bron moet deze vrijgeven wanneer het gebruik ervan is voltooid, bijvoorbeeld met using. Gebruik de bron daarna niet meer. Roep Dispose() pas aan nadat alle andere bewerkingen op die bron zijn voltooid; de aanroep mag niet gelijktijdig met die bewerkingen plaatsvinden.
Het net10.0-voorbeeld leest de tokenstatus, roept Cancel() aan en leest de status opnieuw. Bij het verlaten van het using-blok wordt Dispose() aangeroepen vóór het laatste bericht. Doordat er geen timers of achtergrondtaken zijn, is de uitvoervolgorde deterministisch.
Voorbeelden
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.");Resultaat
Before: False After: True Source disposed.
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.