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`.
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
Console.WriteLine(Calc());
int Calc()
{
await Task.Delay(10);
return 42;
}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ă
class Notificari
{
public void Trimite()
{
await Task.Delay(10);
Console.WriteLine("Trimis");
}
}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
Func<Task> sarcina = () =>
{
await Task.Delay(10);
};Func<Task> sarcina = async () =>
{
await Task.Delay(10);
};Lambda-urile cu await au nevoie și ele de async (altfel CS4034).
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.
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;
}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.
Reparația
int a = await Descarca("raport.pdf", 120);
int b = await Descarca("poze.zip", 340);
Console.WriteLine($"Total: {a + b} KB");
async Task<int> Descarca(string fisier, int kb)
{
await Task.Delay(20);
Console.WriteLine($"{fisier}: {kb} KB");
return kb;
}De ce merge
Descarca folosea await Task.Delay, dar nu era marcată async, iar tipul de retur era int. Ca metodă async Task<int>, ea poate aștepta și întoarce la final dimensiunea. Apelurile trebuie să aștepte rezultatul cu await, altfel ar primi un Task<int>, nu un număr. În Program.cs, await e permis direct la nivelul de sus.
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 deawait; 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ă
asyncpână sus, în loc să blochezi cu.Resultsau.Wait(). - În lambda-uri cu
await, scrieasyncî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
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 CS0029: Cannot implicitly convert type 'string' to 'int' Pui o valoare de un tip într-o variabilă de alt tip, între care nu există conversie automată: un text (`string`) într-un `int`. Convertește explicit cu `int.Parse` sau `int.TryParse`, ori schimbă tipul variabilei. error CS0161: 'Calificativ(int)': not all code paths return a value Metoda ta are un tip de întoarcere (de exemplu `string`), dar există cel puțin un drum prin cod care ajunge la final fără `return`. Adaugă un `return` pentru cazul rămas (un `else` sau un `return` la sfârșitul metodei). Î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.
