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"`).
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Variabilele de tip referință (string, tablouri, liste, clasele tale) pot avea valoarea null, care înseamnă „nu indic spre niciun obiect”. Când scrii nume.Length și nume este null, nu există niciun obiect al cărui Length să fie citit, așa că runtime-ul aruncă NullReferenceException: „referința la obiect nu e setată la o instanță a unui obiect”.
Excepția apare la rulare, nu la compilare. Prima linie din stack trace (at Program.<Main>$(String[] args) in Program.cs:line 2) arată linia exactă. Pe linia aceea, caută fiecare punct (.) și fiecare [: valoarea din stânga unuia dintre ele este null.
Cauze frecvente: un câmp sau o proprietate de tip listă declarat dar neinițializat (public List<string> Note;); o metodă care întoarce null când nu găsește ceva (FirstOrDefault, Find, o căutare proprie); un element null într-un tablou de obiecte (new Produs[3] creează trei null-uri); sau un parametru primit null.
Proiectele noi activează adesea Nullable reference types, care avertizează la compilare despre aceste situații.
De ce apare: cauzele frecvente
1Listă declarată, dar necreată
var c = new Clasa();
c.Elevi.Add("Ana");
class Clasa
{
public List<string> Elevi;
}var c = new Clasa();
c.Elevi.Add("Ana");
class Clasa
{
public List<string> Elevi = new List<string>();
}Câmpul Elevi pornea cu null. Inițializarea cu new List<string>() creează lista înainte de primul Add.
2Rezultatul lui FirstOrDefault folosit fără verificare
var nume = new List<string> { "Ana", "Dan" };
string gasit = nume.FirstOrDefault(n => n.StartsWith("Z"));
Console.WriteLine(gasit.Length);var nume = new List<string> { "Ana", "Dan" };
string gasit = nume.FirstOrDefault(n => n.StartsWith("Z"));
Console.WriteLine(gasit?.Length ?? 0);FirstOrDefault întoarce null când nu găsește nimic. ?. oprește accesul dacă e null, iar ?? dă o valoare implicită.
3Tablou de obiecte cu elemente necreate
var produse = new Produs[2];
Console.WriteLine(produse[0].Nume);
class Produs { public string Nume = "Pix"; }var produse = new Produs[2];
for (int i = 0; i < produse.Length; i++)
produse[i] = new Produs();
Console.WriteLine(produse[0].Nume);
class Produs { public string Nume = "Pix"; }new Produs[2] creează doar tabloul, cu două poziții null. Fiecare obiect trebuie creat separat.
Repară eroarea, direct în pagină
Programul caută în catalog un elev după nume și afișează câte note are, dar la rulare primești System.NullReferenceException: Object reference not set to an instance of an object. Repară programul, astfel încât notele să fie adăugate fără eroare, iar pentru un elev inexistent să se afișeze „negasit”.
var elevi = new List<Elev> { new Elev { Nume = "Ana" }, new Elev { Nume = "Dan" } };
elevi[0].Note.Add(9);
elevi[0].Note.Add(10);
foreach (string cautat in new[] { "Ana", "Mihai" })
{
Elev e = elevi.FirstOrDefault(x => x.Nume == cautat);
Console.WriteLine($"{cautat}: {e.Note.Count}");
}
class Elev
{
public string Nume;
public List<int> Note;
}Ana: 2 Mihai: negasit
Indiciu
Lista Note din clasa Elev nu e creată niciodată; iar FirstOrDefault poate întoarce null.
Reparația
var elevi = new List<Elev> { new Elev { Nume = "Ana" }, new Elev { Nume = "Dan" } };
elevi[0].Note.Add(9);
elevi[0].Note.Add(10);
foreach (string cautat in new[] { "Ana", "Mihai" })
{
Elev e = elevi.FirstOrDefault(x => x.Nume == cautat);
Console.WriteLine($"{cautat}: {e?.Note.Count.ToString() ?? "negasit"}");
}
class Elev
{
public string Nume;
public List<int> Note = new List<int>();
}De ce merge
Erau două surse de null. Câmpul Note era declarat, dar necreat, deci primul Add era apelat pe null; acum lista e inițializată la declarare. Apoi FirstOrDefault întoarce null pentru „Mihai”, care nu există. Cu ?. și ??, accesul la Note.Count se face doar dacă elevul a fost găsit, altfel se afișează „negasit”. Astfel programul tratează explicit ambele cazuri.
Alte forme ale mesajului
Unhandled exception. System.NullReferenceException: Object reference not set to an instance of an object.
Cum o eviți pe viitor
- Inițializează colecțiile chiar la declarare:
public List<string> Note { get; } = new();. - Verifică rezultatul metodelor care pot întoarce
null(FirstOrDefault,Find,TryGetValuecu obiecte). - Folosește operatorii pentru null:
x?.Membru,x ?? valoareImplicita,x ??= new(). - Activează
<Nullable>enable</Nullable>în proiect și citește avertismentele CS8602/CS8618: ele îți arată din timp locurile periculoase. - Validează parametrii la intrarea în metode publice (
ArgumentNullException.ThrowIfNull(x)).
Întrebări frecvente
Cum aflu care variabilă e null dacă linia are mai multe?
Sparge linia în mai multe instrucțiuni, cu variabile intermediare, sau pune un breakpoint și inspectează valorile în debugger. Fiecare . sau [ poate fi locul problemei.
Ar trebui să prind excepția cu try/catch?
Aproape niciodată. NullReferenceException indică o greșeală în cod, nu o situație normală. Repară cauza: inițializează obiectul sau verifică explicit null acolo unde valoarea poate lipsi.
Ce e ?. și ???
a?.B întoarce null dacă a e null, în loc să arunce excepție. a ?? b întoarce a dacă nu e null, altfel b. Împreună: nume?.Length ?? 0.
Erori înrudite
System.InvalidOperationException: Nullable object must have a value. Ai citit `.Value` (sau ai făcut cast `(int)`) dintr-o variabilă nullable (`int?`, `decimal?`, `DateTime?`) care este `null`. Verifică înainte cu `HasValue` sau folosește o valoare implicită: `stoc ?? 0` sau `stoc.GetValueOrDefault()`. 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)`. error CS0165: Use of unassigned local variable 'bonus' Citești o variabilă locală care, pe cel puțin un drum prin cod, nu a primit nicio valoare. Dă-i o valoare inițială la declarare (`int bonus = 0;`) sau asigură-te că toate ramurile (`if`/`else`, `switch`) îi atribuie una. Î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.
