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

CKTIS / C#

CancellationTokenSource — vyžiadanie zrušenia a uvoľnenie prostriedkov

CancellationTokenSource spravuje kooperatívne rušenie pomocou CancellationToken. Cancel žiada o zastavenie práce, zatiaľ čo Dispose uvoľňuje prostriedky a operácie neruší.

Verzia: .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 sprístupňuje prostredníctvom Token token, ktorý sa odovzdáva operáciám. Cancel() nastaví IsCancellationRequested na true vo všetkých kópiách tohto tokenu. Rušenie je kooperatívne: kód, ktorý token prijme, musí reagovať; samotná žiadosť vlákno násilne neukončí. Pomocou CancelAfter(...) možno naplánovať žiadosť po určenom oneskorení.

CancellationTokenSource.Dispose() uvoľňuje prostriedky, ale nežiada o zrušenie a nenahrádza čakanie na dokončenie práce. Vlastník zdroja by ho mal uvoľniť, keď ho prestane používať, napríklad pomocou using. Potom zdroj nepoužívajte. Dispose() zavolajte až po dokončení všetkých ostatných operácií s týmto zdrojom; nesmie prebiehať súčasne s nimi.

Príklad pre net10.0 prečíta stav tokenu, zavolá Cancel() a stav prečíta znova. Pri opustení bloku using sa pred záverečnou správou zavolá Dispose(). Keďže sa nepoužívajú časovače ani úlohy na pozadí, poradie výstupu je deterministické.

Príklady

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

Výsledok

Before: False
After: True
Source disposed.

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje