0Pricing
C# Academy · Lekcja

Wzorce CancellationToken i kooperacyjne anulowanie

Proszę przekazywać i respektować CancellationToken: tworzyć CTS, sprawdzać anulowanie lub zgłaszać wyjątek, przekazywać token do API async oraz sprzątać za pomocą rejestracji.

Wzorce CancellationToken i kooperacyjne anulowanie to bezpłatna lekcja C# Academy na CoddyKit. To lekcja 1 z 3. Możesz przeczytać całą lekcję poniżej za darmo — a potem ćwiczyć ją interaktywnie w przeglądarce z wbudowanym edytorem kodu i tutorem AI dostępnym 24/7. To część ścieżki edukacyjnej C# Academy, a Twój postęp synchronizuje się między webem a aplikacją CoddyKit. Kurs C# Academy zawiera 3 lekcji w sumie.

Anulowanie współdziałające

Cel: Anulowanie pracy w sposób współdziałający.

  • Utworzenie obiektu CancellationTokenSource
  • Przekazywanie obiektu CancellationToken dalej
  • Sprawdzanie właściwości IsCancellationRequested lub wywoływanie metody ThrowIfCancellationRequested()
  • Szybkie i poprawne reagowanie na anulowanie

Anulowanie sterowane przez wywołującego

Należy utworzyć obiekt CancellationTokenSource, przekazać token i anulować operację w metodzie wywołującej; metoda wywoływana zgłasza wyjątek OperationCanceledException.

using System;
using System.Threading;
using System.Threading.Tasks;

public class Program
{
  static async Task WorkAsync(CancellationToken ct)
  {
    // Poll occasionally; throw to end cooperatively
    for (int i = 0; i < 5; i++)
    {
      ct.ThrowIfCancellationRequested();
      Console.WriteLine("Step " + i);
      await Task.Delay(100, ct); // pass token to async API
    }
  }

  public static void Main(string[] args)
  {
    var cts = new CancellationTokenSource();
    Task t = WorkAsync(cts.Token);

    // Cancel after a short delay (simulated user action)
    Thread.Sleep(180);
    cts.Cancel();

    try
    {
      t.GetAwaiter().GetResult();
    }
    catch (OperationCanceledException)
    {
      Console.WriteLine("Canceled!");
    }
  }
}

Przekazywanie tokenów

Należy przekazywać token przez każdą warstwę asynchroniczną, aby wewnętrzne wywołania mogły szybko się zatrzymać.

using System;
using System.Threading;
using System.Threading.Tasks;

public class Program
{
  static async Task<string> FetchAsync(CancellationToken ct)
  {
    await Task.Delay(80, ct); // pretend I/O
    ct.ThrowIfCancellationRequested();
    return "data";
  }

  static async Task<string> ProcessAsync(CancellationToken ct)
  {
    string raw = await FetchAsync(ct); // forward token
    await Task.Delay(80, ct);
    return raw.ToUpperInvariant();
  }

  public static void Main(string[] args)
  {
    var cts = new CancellationTokenSource();
    Task<string> job = ProcessAsync(cts.Token);
    cts.CancelAfter(100); // schedule a cancellation
    try
    {
      Console.WriteLine(job.GetAwaiter().GetResult());
    }
    catch (OperationCanceledException)
    {
      Console.WriteLine("Pipeline canceled");
    }
  }
}

Czyszczenie za pomocą token.Register

Należy używać token.Register do dołączania niewielkiej akcji porządkującej, która zostanie wykonana po zażądaniu anulowania.

using System;
using System.Threading;
using System.Threading.Tasks;

public class Program
{
  static async Task UseRegistrationAsync(CancellationToken ct)
  {
    using (ct.Register(() => Console.WriteLine("Cleanup: releasing temp resources")))
    {
      for (int i = 0; i < 3; i++)
      {
        ct.ThrowIfCancellationRequested();
        await Task.Delay(120, ct);
        Console.WriteLine("Tick " + i);
      }
    }
  }

  public static void Main(string[] args)
  {
    var cts = new CancellationTokenSource();
    Task t = UseRegistrationAsync(cts.Token);
    Thread.Sleep(150);
    cts.Cancel();
    try { t.GetAwaiter().GetResult(); }
    catch (OperationCanceledException) { Console.WriteLine("Canceled with cleanup"); }
  }
}

Połączone źródła

CreateLinkedTokenSource łączy wiele sygnałów (np. anulowanie przez użytkownika i limit czasu) w jeden token.

using System;
using System.Threading;
using System.Threading.Tasks;

public class Program
{
  static async Task WorkAsync(CancellationToken ct)
  {
    await Task.Delay(500, ct);
    Console.WriteLine("Finished work");
  }

  public static void Main(string[] args)
  {
    var parent = new CancellationTokenSource();
    var timeout = new CancellationTokenSource();
    timeout.CancelAfter(200);

    // Link both sources: cancel if parent OR timeout requests
    var linked = CancellationTokenSource.CreateLinkedTokenSource(parent.Token, timeout.Token);

    Task t = WorkAsync(linked.Token);
    try { t.GetAwaiter().GetResult(); }
    catch (OperationCanceledException) { Console.WriteLine("Canceled by parent/timeout"); }
    finally { linked.Dispose(); parent.Dispose(); timeout.Dispose(); }
  }
}

Najlepsze praktyki

Wskazówki:

  • Należy przekazywać tokeny do asynchronicznych interfejsów API (Task.Delay, operacje I/O), aby mogły szybko się zatrzymać.
  • Należy zgłaszać wyjątek OperationCanceledException, aby zakończyć pracę; nie należy go przechwytywać bez obsługi.
  • Należy wywoływać Dispose dla obiektu CancellationTokenSource, jeśli zarządza on licznikami czasu lub rejestracjami.
  • Procedury obsługi powinny działać szybko; w metodzie Register należy wykonywać minimalną ilość pracy.

Reguła współdziałającego anulowania

Szybkie sprawdzenie: Jaki jest prawidłowy sposób reagowania metody na żądanie anulowania?

Podsumowanie

Podsumowanie: Anulowanie powinno odbywać się w sposób współdziałający — należy przekazywać tokeny, sprawdzać ich stan lub wywoływać ThrowIfCancellationRequested, dołączać niewielkie akcje porządkujące i łączyć źródła dla sygnałów pochodzących z wielu miejsc.

Często zadawane pytania

Czy lekcja „Wzorce CancellationToken i kooperacyjne anulowanie” jest bezpłatna?

Tak — pełny tekst „Wzorce CancellationToken i kooperacyjne anulowanie” jest dostępny za darmo tutaj w sieci. Aby ćwiczyć ją interaktywnie (wbudowany edytor kodu i tutor AI dostępny 24/7) i odblokować resztę kursu C# Academy, przejdź na CoddyKit PRO. Kurs C# Academy zawiera 3 lekcji w sumie.

Co nauczysz się w „Wzorce CancellationToken i kooperacyjne anulowanie”?

Proszę przekazywać i respektować CancellationToken: tworzyć CTS, sprawdzać anulowanie lub zgłaszać wyjątek, przekazywać token do API async oraz sprzątać za pomocą rejestracji. Ćwiczysz C# Academy z praktycznym kodem, który uruchamiasz bezpośrednio w przeglądarce, a tutor AI dostępny 24/7 odpowiada na Twoje pytania podczas pracy nad lekcją.

Czy potrzebuję doświadczenia, aby zacząć C# Academy?

Nie wymagamy żadnego doświadczenia. C# Academy w CoddyKit jest strukturyzowany dla początkujących i zaawansowanych użytkowników, więc możesz zacząć tutaj lub od początku i uczyć się w swoim tempie. To lekcja 1 z 3.

Ile czasu zajmuje lekcja „Wzorce CancellationToken i kooperacyjne anulowanie”?

Większość lekcji CoddyKit trwa około 5–10 minut. Każda lekcja to mały, interaktywny krok, dzięki czemu robisz systematyczne postępy i zawsze wracasz dokładnie do tego samego miejsca — na webie i w aplikacji.

Czy mogę pisać i uruchamiać kod w tej lekcji C# Academy?

Tak. Każda lekcja C# Academy zawiera wbudowany edytor kodu, więc piszesz i uruchamiasz prawdziwy kod bezpośrednio w przeglądarce i od razu otrzymujesz sprzężenie zwrotne od AI — bez konfiguracji na komputerze.

Wszystkie lekcje w tym kursie

  1. Wzorce CancellationToken i kooperacyjne anulowanie
  2. Limity czasu, IProgress i zasoby async (emulacja)
  3. Podstawy odporności: ponawianie i backoff
← Powrót do C# Academy