Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / C#

CancellationTokenSource — zahteva za preklic in sprostitev virov

CancellationTokenSource upravlja sodelovalni preklic prek CancellationToken. Cancel zahteva ustavitev dela, Dispose pa sprosti vire in operacij ne prekliče.

Različica: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification

Sintaksa

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 prek Token ponudi žeton, ki se posreduje operacijam. Cancel() nastavi IsCancellationRequested na true v vsaki kopiji tega žetona. Preklic je sodelovalen: koda, ki prejme žeton, se mora odzvati; sama zahteva niti ne prekine na silo. Z CancelAfter(...) lahko zahtevo načrtujete po določeni zakasnitvi.

CancellationTokenSource.Dispose() sprosti vire, vendar ne zahteva preklica in ne nadomesti čakanja, da se delo konča. Lastnik vira naj ga sprosti, ko ga ne uporablja več, na primer z using. Vira nato ne uporabljajte več. Dispose() pokličite šele, ko so končane vse druge operacije nad tem virom; ne sme se izvajati sočasno z njimi.

Primer za net10.0 prebere stanje žetona, pokliče Cancel() in stanje prebere še enkrat. Ob izhodu iz bloka using se pred zadnjim sporočilom pokliče Dispose(). Ker ni časovnikov ali opravil v ozadju, je vrstni red izpisa determinističen.

Primeri

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

Rezultat

Before: False
After: True
Source disposed.

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri