System.ArgumentNullException: Value cannot be null. (Parameter 'source')
Ai trimis `null` unei metode care nu-l acceptă. Numele din paranteză (`'source'`, `'key'`, `'s'`) e parametrul care a primit `null`: `source` înseamnă de obicei o colecție `null` folosită cu LINQ. Asigură-te că valoarea există (inițializează colecția, verifică înainte) sau tratează lipsa ei.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
ArgumentNullException este aruncată de metodele care își verifică parametrii la intrare. Spre deosebire de NullReferenceException, aici nu tu ai accesat un membru pe null; metoda a observat că i-ai dat null și te-a oprit, spunându-ți și ce parametru: (Parameter 'source').
Cum citești numele parametrului:
'source': o metodă LINQ (Where,Select,Count,Sum,ToList) a fost apelată pe o colecțienull;'key': ai folositnulldrept cheie într-unDictionary;'s'sau'input':int.Parse(null),Regex.IsMatch(null, ...);'value','path','collection'și altele: parametrul cu acel nume al metodei din stiva de apeluri.
Prima linie din stack trace care e în codul tău (in Program.cs:line 2) arată apelul. De acolo, urmărește de unde vine valoarea null: o metodă care întoarce null în loc de o colecție goală, un câmp neinițializat, o deserializare cu câmp lipsă.
De ce apare: cauzele frecvente
1LINQ pe o listă null
List<int> note = null;
Console.WriteLine(note.Where(n => n >= 5).Count());List<int> note = new List<int>();
Console.WriteLine(note.Where(n => n >= 5).Count());Metodele LINQ verifică dacă sursa e null. O listă goală dă pur și simplu 0.
2Cheie null în dicționar
var stoc = new Dictionary<string, int>();
string cod = null;
stoc[cod] = 5;var stoc = new Dictionary<string, int>();
string cod = null;
if (cod != null) stoc[cod] = 5;Dictionary nu acceptă chei null (Parameter 'key'). Verifică cheia înainte.
3int.Parse pe o valoare lipsă
string varsta = null;
int v = int.Parse(varsta);string varsta = null;
int v = int.TryParse(varsta, out int x) ? x : 0;TryParse întoarce false pentru null, fără excepție.
Repară eroarea, direct în pagină
Programul calculează totalul comenzilor fiecărui client, dar se oprește cu System.ArgumentNullException: Value cannot be null. (Parameter 'source'). Clientul „Dan” nu are încă nicio comandă. Repară metoda Comenzi, astfel încât să afișeze totalul pentru fiecare client (0 pentru Dan).
var comenzi = new Dictionary<string, List<decimal>>
{
["Ana"] = new List<decimal> { 120m, 80m },
["Ion"] = new List<decimal> { 45.5m }
};
foreach (string client in new[] { "Ana", "Dan", "Ion" })
Console.WriteLine($"{client}: {Comenzi(client).Sum():F2}");
List<decimal> Comenzi(string client)
{
if (comenzi.TryGetValue(client, out var lista)) return lista;
return null;
}Ana: 200.00 Dan: 0.00 Ion: 45.50
Indiciu
Metoda întoarce null pentru clienții fără comenzi; Sum nu acceptă o sursă null.
Reparația
var comenzi = new Dictionary<string, List<decimal>>
{
["Ana"] = new List<decimal> { 120m, 80m },
["Ion"] = new List<decimal> { 45.5m }
};
foreach (string client in new[] { "Ana", "Dan", "Ion" })
Console.WriteLine($"{client}: {Comenzi(client).Sum():F2}");
List<decimal> Comenzi(string client)
{
if (comenzi.TryGetValue(client, out var lista)) return lista;
return new List<decimal>();
}De ce merge
Pentru „Dan”, Comenzi întorcea null, iar Sum() (o metodă LINQ) a verificat parametrul source și a aruncat ArgumentNullException. Când metoda întoarce o listă goală în loc de null, Sum() dă 0, fără nicio verificare suplimentară în codul care o folosește. Convenția .NET este tocmai aceasta: colecțiile lipsă sunt goale, nu null.
Alte forme ale mesajului
System.ArgumentNullException: Value cannot be null. (Parameter 'key')System.ArgumentNullException: Value cannot be null. (Parameter 's')Unhandled exception. System.ArgumentNullException: Value cannot be null. (Parameter 'source')
Cum o eviți pe viitor
- Metodele care întorc colecții să întoarcă o colecție goală, nu
null(return new List<int>();,Array.Empty<int>()). - Inițializează listele chiar la declarare:
public List<int> Note { get; } = new();. - În metodele tale publice, validează parametrii la început cu
ArgumentNullException.ThrowIfNull(param);: eroarea apare imediat, cu numele corect. - Pentru colecții care pot lipsi, folosește
lista ?? Enumerable.Empty<int>().
Întrebări frecvente
Care e diferența față de NullReferenceException?
NullReferenceException apare când accesezi un membru pe null (x.Length). ArgumentNullException e aruncată intenționat de o metodă care a primit null ca argument și îți spune ce parametru.
De unde știu ce e source dacă eu n-am niciun parametru cu numele ăsta?
E numele parametrului din metoda .NET. Toate metodele LINQ numesc colecția de intrare source, deci caută pe linia indicată colecția pe care ai aplicat LINQ.
Erori înrudite
System.NullReferenceException: Object reference not set to an instance of an object. Ai folosit un membru (`.Length`, `.Nume`, o metodă) pe o variabilă care are valoarea `null`, adică nu indică spre niciun obiect. Găsește pe linia din stack trace ce variabilă e `null` și fie îi dai un obiect (`new ...`), fie verifici înainte (`if (x != null)`, `x?.Length`, `x ?? "implicit"`). System.Collections.Generic.KeyNotFoundException: The given key 'pere' was not present in the dictionary. Ai citit dintr-un `Dictionary` o cheie care nu există (`stoc["pere"]`). Verifică înainte cu `TryGetValue(cheie, out var valoare)` sau `ContainsKey`, ori folosește `GetValueOrDefault(cheie)`. System.FormatException: The input string 'abc' was not in a correct format. `int.Parse` (sau `double.Parse`, `Convert.ToInt32`) a primit un text care nu este un număr valid: litere, șir gol, zecimale într-un `int`. Folosește `int.TryParse(text, out int n)` și tratează cazul în care întoarce `false`. Î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.
