System.Threading.Tasks.TaskCanceledException: A task was canceled.
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ă
var cts = new CancellationTokenSource();
cts.Cancel();
await Task.Delay(1000, cts.Token);
Console.WriteLine("Gata");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
using var cts = new CancellationTokenSource(TimeSpan.FromMilliseconds(10));
await Task.Delay(500, cts.Token);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ă 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.
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}");Descarcat a.pdf Descarcare anulata Fisiere descarcate: 1
Indiciu
Pune bucla de descărcare într-un try și prinde OperationCanceledException.
Reparația
var cts = new CancellationTokenSource();
int descarcate = 0;
try
{
foreach (string f in new[] { "a.pdf", "b.pdf", "c.pdf" })
{
await Task.Delay(50, cts.Token);
Console.WriteLine($"Descarcat {f}");
descarcate++;
cts.Cancel();
}
}
catch (OperationCanceledException)
{
Console.WriteLine("Descarcare anulata");
}
Console.WriteLine($"Fisiere descarcate: {descarcate}");De ce merge
După cts.Cancel(), următorul Task.Delay(50, token) arunca TaskCanceledException, iar fără tratare programul se oprea. Cu try/catch (OperationCanceledException) (clasa de bază a lui TaskCanceledException), anularea devine un caz normal: se afișează mesajul, iar codul de după catch raportează câte fișiere apucaseră să fie descărcate.
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
CancellationTokenprin toate metodele asincrone, până la operațiile de jos (Task.Delay, apelurile HTTP). - Alege timeout-uri realiste și configurează
HttpClient.Timeoutexplicit. - 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
System.AggregateException: One or more errors occurred. (Moneda USD nu este suportata) Un `Task` s-a terminat cu o excepție, iar tu i-ai citit rezultatul cu `.Result` sau `.Wait()`. Acestea împachetează excepția reală într-un `AggregateException`; mesajul ei apare în paranteză și pe linia `--->`. Folosește `await` (care aruncă direct excepția originală) și prinde acel tip de excepție. error CS4032: The 'await' operator can only be used within an async method. Consider marking this method with the 'async' modifier and changing its return type to 'Task<int>'. Ai folosit `await` într-o metodă care nu e marcată `async`. Adaugă `async` în semnătură și schimbă tipul de retur după sugestia din mesaj: `int` devine `Task<int>`, `void` devine `Task`. Apoi apelează metoda tot cu `await`. System.NullReferenceException: Object reference not set to an instance of an object. Ai folosit un membru (`.Length`, `.Nume`, o metodă) pe o variabilă care are valoarea `null`, adică nu indică spre niciun obiect. Găsește pe linia din stack trace ce variabilă e `null` și fie îi dai un obiect (`new ...`), fie verifici înainte (`if (x != null)`, `x?.Length`, `x ?? "implicit"`). Î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.
