error CS1988: Async methods cannot have ref, in or out parameters
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 cuvar (ok, pret) = await CitestePretAsync("A1"); - un tip propriu (
record Rezultat(bool Ok, decimal Pret)), dacă rezultatul are multe câmpuri; nullpentru „nu există”:Task<decimal?>.
De ce apare: cauzele frecvente
1TryParse asincron cu out
static async Task<bool> TryCitesteAsync(string cod, out int stoc)
{
await Task.Delay(1);
stoc = 5;
return true;
}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
static async Task ProceseazaAsync(ref int procesate)
{
await Task.Delay(1);
procesate++;
}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ă
static async Task<bool> GasesteAsync(int id, out Produs p) { ... }static async Task<Produs?> GasesteAsync(int id) { ... }null înseamnă „negăsit”, iar apelantul verifică rezultatul.
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.
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);
}A1: 12.50 lei Z9: negasit
Indiciu
Întoarce Task<(bool Ok, decimal Pret)> și despachetează rezultatul după await.
Reparația
var preturi = new Dictionary<string, decimal> { ["A1"] = 12.5m };
foreach (string cod in new[] { "A1", "Z9" })
{
var (ok, pret) = await TryPretAsync(cod);
if (ok)
Console.WriteLine($"{cod}: {pret:F2} lei");
else
Console.WriteLine($"{cod}: negasit");
}
async Task<(bool Ok, decimal Pret)> TryPretAsync(string cod)
{
await Task.Delay(1);
bool ok = preturi.TryGetValue(cod, out decimal pret);
return (ok, pret);
}De ce merge
O metodă async nu poate avea parametri out, pentru că poate continua după ce apelantul a mers mai departe. Tuplul (bool Ok, decimal Pret) duce ambele informații prin Task. Apelantul așteaptă rezultatul și îl despachetează cu var (ok, pret) = await ..., apoi afișează prețul sau „negasit”.
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 înTask<T>. - Folosește tupluri cu nume (
(bool Ok, int Stoc)) pentru 2-3 rezultate șirecordpentru 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
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;`. error CS0177: The out parameter 'rest' must be assigned to before control leaves the current method Metoda are un parametru `out` căruia nu îi dai valoare pe toate drumurile până la ieșire. Fiecare parametru `out` trebuie atribuit în metodă înainte de orice `return` (și la final), chiar și în cazurile de eroare. 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`. Î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.
