error CS1997: Since 'Salveaza()' is an async method that returns 'Task', a return keyword must not be followed by an object expression
Metoda e `async Task` (fără rezultat), dar ai scris `return valoare;`. Dacă metoda trebuie să întoarcă ceva, declar-o `async Task<int>` (cu tipul valorii). Dacă nu, scrie doar `return;` sau șterge `return`.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
În metodele async, tipul declarat descrie task-ul, nu valoarea:
async Task= metoda nu produce nicio valoare (echivalentul asincron al luivoid);async Task<int>= metoda produce unint, pe care îl scrii direct:return 5;(compilatorul îl pune singur în task).
Când metoda e async Task și scrii return 5;, compilatorul raportează CS1997: Since 'Salveaza()' is an async method that returns 'Task', a return keyword must not be followed by an object expression. Cu alte cuvinte: un Task simplu nu are loc pentru o valoare.
Apare des când transformi o metodă sincronă int Salveaza() în async și scrii async Task în loc de async Task<int>. După reparație, apelantul primește valoarea cu int id = await Salveaza();.
De ce apare: cauzele frecvente
1Lipsește tipul rezultatului
static async Task Salveaza()
{
await Task.Delay(1);
return 42;
}static async Task<int> Salveaza()
{
await Task.Delay(1);
return 42;
}Task<int> spune că metoda produce un int după terminare.
2Metoda nu trebuie să întoarcă nimic
static async Task Trimite(string email)
{
await Task.Delay(1);
return true;
}static async Task Trimite(string email)
{
await Task.Delay(1);
}Dacă nimeni nu folosește rezultatul, scoți return valoare;. Erorile se semnalează cu excepții.
3return Task.CompletedTask într-o metodă async
static async Task Log(string m)
{
await Task.Delay(1);
return Task.CompletedTask;
}static async Task Log(string m)
{
await Task.Delay(1);
}Într-o metodă async, task-ul e creat de compilator. return Task.CompletedTask; se scrie doar în metodele fără async.
Repară eroarea, direct în pagină
Metoda SalveazaComanda salvează o comandă și ar trebui să întoarcă numărul ei, dar programul nu compilează: error CS1997: Since 'SalveazaComanda(string)' is an async method that returns 'Task', a return keyword must not be followed by an object expression. Repară metoda să întoarcă numărul comenzii, iar programul să-l afișeze: Comanda 1001 salvata pentru Ana.
await SalveazaComanda("Ana");
Console.WriteLine("Comanda salvata pentru Ana");
static async Task SalveazaComanda(string client)
{
await Task.Delay(10);
return 1001;
}Comanda 1001 salvata pentru Ana
Indiciu
Tipul de întoarcere trebuie să spună ce valoare produce task-ul.
Reparația
int nr = await SalveazaComanda("Ana");
Console.WriteLine($"Comanda {nr} salvata pentru Ana");
static async Task<int> SalveazaComanda(string client)
{
await Task.Delay(10);
return 1001;
}De ce merge
async Task descrie o metodă care nu produce nicio valoare, așa că return 1001; nu avea unde să pună numărul. Cu async Task<int>, compilatorul împachetează valoarea în task, iar apelantul o primește cu int nr = await SalveazaComanda("Ana");. Fără await, apelantul ar primi task-ul, nu numărul.
Alte forme ale mesajului
error CS1997: Since 'Program.Salveaza()' is an async method that returns 'Task', a return keyword must not be followed by an object expression
Cum o eviți pe viitor
- Când transformi o metodă în
async,voiddevineTask, iarintdevineTask<int>. - În metodele
asyncreturnezi direct valoarea (return 42;), nu un task. - Lasă editorul să schimbe semnătura (Ctrl+. pe eroare propune „Change return type”).
- Dacă metoda doar face o acțiune, păstrează
Taskși scoate valoarea dinreturn.
Întrebări frecvente
De ce în metodele fără async trebuie să scriu Task.FromResult(42)?
Pentru că acolo nu există compilatorul care să împacheteze valoarea. Doar cuvântul async transformă return 42; într-un Task<int> terminat.
E la fel cu CS0127?
Seamănă: CS0127 apare la metodele void sincrone care întorc o valoare. CS1997 e varianta pentru metodele async Task.
Erori înrudite
error CS0127: Since 'Afiseaza()' returns void, a return keyword must not be followed by an object expression Metoda e declarată `void` (nu întoarce nimic), dar ai scris `return valoare;` în ea. Dacă metoda trebuie să dea un rezultat, schimbă `void` în tipul lui (`int`, `string`, `decimal`). Dacă nu, scrie doar `return;` sau șterge `return`. 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 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.
