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

error CS1997: Since 'Salveaza()' is an async method that returns 'Task', a return keyword must not be followed by an object expression

Pe scurt

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 lui void);
  • async Task<int> = metoda produce un int, 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

Greșit
C#
static async Task Salveaza()
{
    await Task.Delay(1);
    return 42;
}
Corect
C#
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

Greșit
C#
static async Task Trimite(string email)
{
    await Task.Delay(1);
    return true;
}
Corect
C#
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

Greșit
C#
static async Task Log(string m)
{
    await Task.Delay(1);
    return Task.CompletedTask;
}
Corect
C#
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ă tu

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.

Codul care dă eroarea
C#
await SalveazaComanda("Ana");
Console.WriteLine("Comanda salvata pentru Ana");

static async Task SalveazaComanda(string client)
{
    await Task.Delay(10);
    return 1001;
}
După reparație, programul afișează
Comanda 1001 salvata pentru Ana
Indiciu

Tipul de întoarcere trebuie să spună ce valoare produce task-ul.

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, void devine Task, iar int devine Task<int>.
  • În metodele async returnezi 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 din return.

Î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

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