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

error CS4008: Cannot await 'void'

Pe scurt

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ă

Greșit
C#
await Salveaza();

async void Salveaza()
{
    await Task.Delay(10);
}
Corect
C#
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ă

Greșit
C#
await Console.Out.FlushAsync();
await Console.WriteLine("Gata");
Corect
C#
await Console.Out.FlushAsync();
Console.WriteLine("Gata");

Console.WriteLine e sincronă și întoarce void. Doar metodele care întorc task-uri se așteaptă.

Repară tu

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.

Codul care dă eroarea
C#
await Salveaza("raport.pdf");
Console.WriteLine("Gata");

async void Salveaza(string fisier)
{
    await Task.Delay(10);
    Console.WriteLine($"Salvat {fisier}");
}
După reparație, programul afișează
Salvat raport.pdf
Gata
Indiciu

Schimbă async void în async Task.

Cum o eviți pe viitor

  • Nu scrie async void decât pentru handler-ele de evenimente; în rest, async Task.
  • Denumește metodele asincrone cu sufixul Async și pune await doar î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

← 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.