error CS4008: Cannot await 'void'
Ai pus `await` în fața unei metode care întoarce `void`, de obicei o metodă `async void`. Doar task-urile pot fi așteptate. Schimbă metoda în `async Task` (sau `async Task<T>` dacă întoarce o valoare), iar `await` va funcționa.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
await are nevoie de un obiect pe care să-l aștepte: un Task, un Task<T>, un ValueTask. O metodă void nu întoarce nimic, deci nu ai ce aștepta, iar compilatorul dă CS4008.
Situația tipică e o metodă declarată async void. Ea rulează asincron, dar apelantul nu are cum să afle când s-a terminat sau dacă a aruncat o excepție. Excepțiile dintr-un async void nu pot fi prinse cu try/catch de apelant și pot opri aplicația. De aceea regula e: async void doar pentru handler-ele de evenimente (button_Click), iar în rest async Task.
Alte cauze: await pus în fața unei metode sincrone (await Console.WriteLine(...), await lista.Add(x)) sau a unei metode proprii care nu e asincronă. Acolo pur și simplu scoate await.
De ce apare: cauzele frecvente
1Metodă async void așteptată
await Salveaza();
async void Salveaza()
{
await Task.Delay(10);
}await Salveaza();
async Task Salveaza()
{
await Task.Delay(10);
}Cu Task ca tip returnat, apelantul primește un obiect pe care îl poate aștepta și din care află excepțiile.
2await pe o metodă sincronă
await Console.Out.FlushAsync();
await Console.WriteLine("Gata");await Console.Out.FlushAsync();
Console.WriteLine("Gata");Console.WriteLine e sincronă și întoarce void. Doar metodele care întorc task-uri se așteaptă.
Repară eroarea, direct în pagină
Programul salvează un raport cu o metodă asincronă și apoi afișează Gata, dar nu compilează: error CS4008: Cannot await 'void'. Repară metoda Salveaza ca programul să afișeze Salvat raport.pdf, apoi Gata.
await Salveaza("raport.pdf");
Console.WriteLine("Gata");
async void Salveaza(string fisier)
{
await Task.Delay(10);
Console.WriteLine($"Salvat {fisier}");
}Salvat raport.pdf Gata
Indiciu
Schimbă async void în async Task.
Reparația
await Salveaza("raport.pdf");
Console.WriteLine("Gata");
async Task Salveaza(string fisier)
{
await Task.Delay(10);
Console.WriteLine($"Salvat {fisier}");
}De ce merge
Salveaza era async void, deci nu întorcea nimic de așteptat, iar await Salveaza(...) nu compila. Ca async Task, metoda întoarce un task care se termină după Task.Delay și afișarea mesajului. await așteaptă acest task, așa că Gata apare garantat după Salvat raport.pdf.
Cum o eviți pe viitor
- Nu scrie
async voiddecât pentru handler-ele de evenimente; în rest,async Task. - Denumește metodele asincrone cu sufixul
Asyncși puneawaitdoar în fața lor. - Activează analizoarele din editor: semnalează
async voidși apelurile asincrone neașteptate. - Dacă o metodă nu are nimic asincron în ea, las-o sincronă și apeleaz-o fără
await.
Întrebări frecvente
De ce e periculos async void?
Pentru că apelantul nu poate aștepta terminarea și nu poate prinde excepțiile. Programul poate continua înainte ca operația să se termine, iar o excepție poate opri tot procesul.
Cum aștept un handler de eveniment async void?
Nu poți. Mută logica într-o metodă async Task (de exemplu SalveazaAsync), pe care handler-ul o apelează cu await. Metoda separată poate fi așteptată și testată.
Erori înrudite
error CS0029: Cannot implicitly convert type 'System.Threading.Tasks.Task<int>' to 'int' Ai apelat o metodă `async` care întoarce `Task<int>` și ai pus rezultatul direct într-un `int`, fără `await`. `Task<int>` e promisiunea unui număr, nu numărul. Scrie `int stoc = await CitesteStoc();`, iar metoda în care ești trebuie să fie și ea `async`. 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`. error CS1983: The return type of an async method must be void, Task, Task<T>, a task-like type, IAsyncEnumerable<T>, or IAsyncEnumerator<T> Ai declarat o metodă `async` care întoarce direct un tip obișnuit (`async int`, `async string`, `async List<Produs>`). O metodă `async` întoarce mereu un task: scrie `async Task<int>`, iar în corp poți păstra `return 250;`. Î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.
