...
Eroare C# · Excepții la rulare: null, conversii, aritmetică

System.ArgumentNullException: Value cannot be null. (Parameter 'source')

Pe scurt

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ție null;
  • 'key': ai folosit null drept cheie într-un Dictionary;
  • '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

Greșit
C#
List<int> note = null;
Console.WriteLine(note.Where(n => n >= 5).Count());
Corect
C#
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

Greșit
C#
var stoc = new Dictionary<string, int>();
string cod = null;
stoc[cod] = 5;
Corect
C#
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ă

Greșit
C#
string varsta = null;
int v = int.Parse(varsta);
Corect
C#
string varsta = null;
int v = int.TryParse(varsta, out int x) ? x : 0;

TryParse întoarce false pentru null, fără excepție.

Repară tu

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

Codul care dă eroarea
C#
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;
}
După reparație, programul afișează
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.

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

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