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

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

Pe scurt

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

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

Ce înseamnă

await poate fi folosit doar în metode (sau lambda-uri) marcate async. Compilatorul îți spune exact cum să repari: „Consider marking this method with the 'async' modifier and changing its return type to 'Task<int>'”. Tipul sugerat ține de ce întorcea metoda: o metodă int devine async Task<int>, iar una void devine async Task (mesajul are atunci codul CS4033).

După schimbare, metoda nu mai întoarce direct int, ci un Task<int>, adică o promisiune că valoarea va veni. Codul care o apelează trebuie fie să facă await (și deci să fie și el async), fie să primească Task-ul. Asta e efectul „async până sus”: async se propagă de la metoda care așteaptă până la punctul de intrare. În Program.cs cu top-level statements, await e permis direct, iar Main poate fi static async Task Main().

Într-un lambda, aceeași greșeală dă CS4034, iar reparația e async () => { ... }.

De ce apare: cauzele frecvente

1Metodă int care folosește await

Greșit
C#
Console.WriteLine(Calc());

int Calc()
{
    await Task.Delay(10);
    return 42;
}
Corect
C#
Console.WriteLine(await Calc());

async Task<int> Calc()
{
    await Task.Delay(10);
    return 42;
}

Metoda devine async Task<int>, iar apelantul așteaptă rezultatul cu await.

2Metodă void dintr-o clasă

Greșit
C#
class Notificari
{
    public void Trimite()
    {
        await Task.Delay(10);
        Console.WriteLine("Trimis");
    }
}
Corect
C#
class Notificari
{
    public async Task Trimite()
    {
        await Task.Delay(10);
        Console.WriteLine("Trimis");
    }
}

void devine Task, ca apelantul să poată aștepta terminarea. Mesajul e CS4033.

3await într-un lambda

Greșit
C#
Func<Task> sarcina = () =>
{
    await Task.Delay(10);
};
Corect
C#
Func<Task> sarcina = async () =>
{
    await Task.Delay(10);
};

Lambda-urile cu await au nevoie și ele de async (altfel CS4034).

Repară tu

Repară eroarea, direct în pagină

Programul simulează descărcarea a două fișiere și afișează dimensiunea totală, dar nu compilează: error CS4032: The 'await' operator can only be used within an async method. Repară metoda Descarca și apelurile ei, astfel încât programul să afișeze dimensiunea fiecărui fișier și totalul.

Codul care dă eroarea
C#
int a = Descarca("raport.pdf", 120);
int b = Descarca("poze.zip", 340);
Console.WriteLine($"Total: {a + b} KB");

int Descarca(string fisier, int kb)
{
    await Task.Delay(20);
    Console.WriteLine($"{fisier}: {kb} KB");
    return kb;
}
După reparație, programul afișează
raport.pdf: 120 KB
poze.zip: 340 KB
Total: 460 KB
Indiciu

Metoda trebuie să fie async Task<int>, iar apelurile trebuie să folosească await.

Alte forme ale mesajului

  • error CS4033: 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'.
  • error CS4034: The 'await' operator can only be used within an async lambda expression. Consider marking this lambda expression with the 'async' modifier.

Cum o eviți pe viitor

  • Scrie async Task / async Task<T> imediat ce o metodă are nevoie de await; evită async void (excepție: handler-ele de evenimente).
  • Denumește metodele asincrone cu sufixul Async (IncarcaAsync), ca să fie evident că trebuie așteptate.
  • Propagă async până sus, în loc să blochezi cu .Result sau .Wait().
  • În lambda-uri cu await, scrie async înaintea parametrilor.

Întrebări frecvente

Pot să scot await și să folosesc .Result?

Tehnic da, dar blochezi firul de execuție și riști blocaje (deadlock) în aplicații cu interfață sau în ASP.NET clasic, plus excepțiile vin împachetate în AggregateException. Preferă await.

De ce în Program.cs merge await fără async?

Pentru că, la top-level statements, compilatorul generează automat un Main asincron atunci când găsește await în fișier.

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.