...
Eroare C# · Async, task-uri și anulare

System.Threading.Tasks.TaskCanceledException: A task was canceled.

Pe scurt

O operație asincronă a fost anulată printr-un `CancellationToken` (de utilizator, de un timeout cu `CancelAfter` sau de `HttpClient.Timeout`) și nu ai tratat anularea. Prinde `OperationCanceledException` acolo unde anularea e un caz normal sau mărește timeout-ul dacă operația chiar are nevoie de mai mult timp.

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

Anularea în .NET funcționează cooperativ: creezi un CancellationTokenSource, transmiți cts.Token metodelor asincrone (Task.Delay, HttpClient.GetAsync, metodele tale), iar când apelezi cts.Cancel() sau expiră CancelAfter, operația aflată în așteptare se oprește aruncând TaskCanceledException. Aceasta derivă din OperationCanceledException (cea aruncată de token.ThrowIfCancellationRequested(), cu mesajul „The operation was canceled.”).

Excepția nu înseamnă neapărat o greșeală: utilizatorul a apăsat „Anulează”, un request a depășit timpul maxim, aplicația se oprește. Greșeala e să nu o tratezi, iar programul să se oprească sau să afișeze o eroare generică.

Cu HttpClient, mesajul are o formă specifică: „The request was canceled due to the configured HttpClient.Timeout of 100 seconds elapsing.” Asta înseamnă că serverul n-a răspuns în timpul implicit de 100 de secunde, nu că ai anulat tu ceva. Verifică serverul, adresa sau mărește HttpClient.Timeout.

De ce apare: cauzele frecvente

1Anulare netratată

Greșit
C#
var cts = new CancellationTokenSource();
cts.Cancel();
await Task.Delay(1000, cts.Token);
Console.WriteLine("Gata");
Corect
C#
var cts = new CancellationTokenSource();
cts.Cancel();
try
{
    await Task.Delay(1000, cts.Token);
    Console.WriteLine("Gata");
}
catch (OperationCanceledException)
{
    Console.WriteLine("Operatie anulata");
}

catch (OperationCanceledException) prinde atât TaskCanceledException, cât și OperationCanceledException.

2Timeout prea mic pentru operație

Greșit
C#
using var cts = new CancellationTokenSource(TimeSpan.FromMilliseconds(10));
await Task.Delay(500, cts.Token);
Corect
C#
using var cts = new CancellationTokenSource(TimeSpan.FromSeconds(5));
await Task.Delay(500, cts.Token);

Timpul maxim trebuie să fie mai mare decât durata normală a operației.

Repară tu

Repară eroarea, direct în pagină

Programul descarcă pe rând trei fișiere, iar după primul utilizatorul apasă „Anulează” (simulat cu cts.Cancel()). Programul se oprește cu System.Threading.Tasks.TaskCanceledException: A task was canceled. Tratează anularea, astfel încât să afișeze fișierul descărcat, apoi „Descarcare anulata” și numărul de fișiere descărcate.

Codul care dă eroarea
C#
var cts = new CancellationTokenSource();
int descarcate = 0;

foreach (string f in new[] { "a.pdf", "b.pdf", "c.pdf" })
{
    await Task.Delay(50, cts.Token);
    Console.WriteLine($"Descarcat {f}");
    descarcate++;
    cts.Cancel();
}

Console.WriteLine($"Fisiere descarcate: {descarcate}");
După reparație, programul afișează
Descarcat a.pdf
Descarcare anulata
Fisiere descarcate: 1
Indiciu

Pune bucla de descărcare într-un try și prinde OperationCanceledException.

Alte forme ale mesajului

  • System.OperationCanceledException: The operation was canceled.
  • System.Threading.Tasks.TaskCanceledException: The request was canceled due to the configured HttpClient.Timeout of 100 seconds elapsing.

Cum o eviți pe viitor

  • Prinde OperationCanceledException (clasa de bază) acolo unde anularea e un rezultat normal și afișează un mesaj clar.
  • Transmite CancellationToken prin toate metodele asincrone, până la operațiile de jos (Task.Delay, apelurile HTTP).
  • Alege timeout-uri realiste și configurează HttpClient.Timeout explicit.
  • Nu prinde anularea cu catch (Exception) generic: o ascunzi printre erorile reale.

Întrebări frecvente

Care e diferența dintre TaskCanceledException și OperationCanceledException?

TaskCanceledException derivă din OperationCanceledException și e aruncată de task-urile anulate (Task.Delay, HttpClient). OperationCanceledException vine din ThrowIfCancellationRequested. Prinde clasa de bază și le acoperi pe amândouă.

La HttpClient, de ce primesc anulare dacă n-am anulat nimic?

Pentru că HttpClient folosește intern un timeout (implicit 100 de secunde). Când expiră, cererea e anulată și primești TaskCanceledException cu mesajul despre HttpClient.Timeout.

Erori înrudite

← Toate erorile C#

Tudor Andrei Dumitrescu
Cine a explicat eroarea

Tudor Andrei Dumitrescu

Senior Software Developer · fondatorul Academiei Programatorilor

LinkedIn
  1. 2019 Junior JavaCognizant Softvision
  2. 2021 Mid JavaCognizant Softvision
  3. 2022 Team LeaderEndava
  4. 2023 Senior Software DeveloperUniCredit
  5. Acum Senior Software DeveloperHCLTech
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu
Certificat de formator autorizatMinisterul Muncii și Ministerul Educației · 2022
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu

Certificat de formator autorizat · Ministerul Muncii și Ministerul Educației · 2022

Din 2020 construiește Academia Programatorilor, iar din 2026 și JoburiIT.ro. Fiecare eroare de aici a fost reprodusă în editorul nostru: codul greșit chiar dă mesajul din titlu, iar reparația chiar funcționează.

Învață C# de la zero, cu exerciții la fiecare lecție

Curs C#: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.