Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / C#

CancellationTokenSource — vyžádání zrušení a uvolnění prostředků

CancellationTokenSource spravuje kooperativní rušení pomocí CancellationToken. Cancel žádá o zastavení práce, zatímco Dispose uvolňuje prostředky a operace neruší.

Verze: .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 zpřístupňuje prostřednictvím Token token, který se předává operacím. Cancel() nastaví IsCancellationRequested na true ve všech kopiích tohoto tokenu. Rušení je kooperativní: kód, který token obdrží, musí reagovat; samotná žádost vlákno násilně neukončí. Pomocí CancelAfter(...) lze naplánovat žádost po stanovené prodlevě.

CancellationTokenSource.Dispose() uvolňuje prostředky, ale nevyžaduje zrušení a nenahrazuje čekání na dokončení práce. Vlastník zdroje by jej měl uvolnit, až jej přestane používat, například pomocí using. Poté zdroj nepoužívejte. Dispose() zavolejte až po dokončení všech ostatních operací s tímto zdrojem; nesmí probíhat souběžně s nimi.

Příklad pro net10.0 přečte stav tokenu, zavolá Cancel() a přečte stav znovu. Při opuštění bloku using se před závěrečnou zprávou zavolá Dispose(). Protože se nepoužívají časovače ani úlohy na pozadí, je pořadí výstupu deterministické.

Pří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ýsledek

Before: False
After: True
Source disposed.

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje