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

error CS1988: Async methods cannot have ref, in or out parameters

Pe scurt

Ai declarat o metodă `async` cu un parametru `out`, `ref` sau `in`, de exemplu o variantă „asincronă” de `TryParse`. Metodele async nu pot avea astfel de parametri. Întoarce rezultatele într-un tuplu: `Task<(bool Ok, int Valoare)>`, sau într-un obiect.

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

Ce înseamnă

O metodă async se poate opri la await și continua mai târziu, după ce apelantul a mers mai departe. Un parametru ref / out / in e o referință la o variabilă a apelantului, care s-ar putea să nu mai existe în momentul în care metoda continuă. De aceea C# interzice combinația și raportează CS1988: Async methods cannot have ref, in or out parameters.

Greșeala apare de obicei când transformi în async o metodă existentă de tip TryX(..., out T rezultat) sau o metodă care întorcea mai multe valori prin out.

Soluția idiomatică este să întorci toate rezultatele în valoarea task-ului:

  • un tuplu: async Task<(bool Ok, decimal Pret)> CitestePretAsync(string cod), folosit cu var (ok, pret) = await CitestePretAsync("A1");
  • un tip propriu (record Rezultat(bool Ok, decimal Pret)), dacă rezultatul are multe câmpuri;
  • null pentru „nu există”: Task<decimal?>.

De ce apare: cauzele frecvente

1TryParse asincron cu out

Greșit
C#
static async Task<bool> TryCitesteAsync(string cod, out int stoc)
{
    await Task.Delay(1);
    stoc = 5;
    return true;
}
Corect
C#
static async Task<(bool Ok, int Stoc)> TryCitesteAsync(string cod)
{
    await Task.Delay(1);
    return (true, 5);
}

Tuplul ține ambele rezultate și ajunge la apelant după await.

2Contor trimis cu ref

Greșit
C#
static async Task ProceseazaAsync(ref int procesate)
{
    await Task.Delay(1);
    procesate++;
}
Corect
C#
static async Task<int> ProceseazaAsync(int procesate)
{
    await Task.Delay(1);
    return procesate + 1;
}

Metoda întoarce noua valoare, iar apelantul o salvează: n = await ProceseazaAsync(n);.

3Valoare opțională

Greșit
C#
static async Task<bool> GasesteAsync(int id, out Produs p) { ... }
Corect
C#
static async Task<Produs?> GasesteAsync(int id) { ... }

null înseamnă „negăsit”, iar apelantul verifică rezultatul.

Repară tu

Repară eroarea, direct în pagină

Metoda TryPretAsync caută prețul unui produs și ar trebui să spună dacă l-a găsit, dar programul nu compilează: error CS1988: Async methods cannot have ref, in or out parameters. Rescrie metoda să întoarcă un tuplu, ca programul să afișeze A1: 12.50 lei și Z9: negasit.

Codul care dă eroarea
C#
var preturi = new Dictionary<string, decimal> { ["A1"] = 12.5m };

foreach (string cod in new[] { "A1", "Z9" })
{
    if (await TryPretAsync(cod, out decimal pret))
        Console.WriteLine($"{cod}: {pret:F2} lei");
    else
        Console.WriteLine($"{cod}: negasit");
}

async Task<bool> TryPretAsync(string cod, out decimal pret)
{
    await Task.Delay(1);
    return preturi.TryGetValue(cod, out pret);
}
După reparație, programul afișează
A1: 12.50 lei
Z9: negasit
Indiciu

Întoarce Task<(bool Ok, decimal Pret)> și despachetează rezultatul după await.

Alte forme ale mesajului

  • error CS1988: Async methods cannot have ref or out parameters

Cum o eviți pe viitor

  • La metodele async, gândește în termeni de valoare întoarsă: tot ce produce metoda trebuie să fie în Task<T>.
  • Folosește tupluri cu nume ((bool Ok, int Stoc)) pentru 2-3 rezultate și record pentru mai multe.
  • Respectă convenția de nume: CitesteAsync, TryCitesteAsync.

Întrebări frecvente

De ce iteratoarele (yield) au aceeași restricție?

Din același motiv: un iterator se execută pe bucăți, la cerere, iar variabilele apelantului s-ar putea să nu mai fie valabile când metoda continuă.

Pot avea o funcție locală non-async cu out în metoda async?

Da. Restricția se aplică doar metodei care este ea însăși async sau iterator.

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.