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

System.NullReferenceException: Object reference not set to an instance of an object.

Pe scurt

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ă

Greșit
C#
var c = new Clasa();
c.Elevi.Add("Ana");

class Clasa
{
    public List<string> Elevi;
}
Corect
C#
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

Greșit
C#
var nume = new List<string> { "Ana", "Dan" };
string gasit = nume.FirstOrDefault(n => n.StartsWith("Z"));
Console.WriteLine(gasit.Length);
Corect
C#
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

Greșit
C#
var produse = new Produs[2];
Console.WriteLine(produse[0].Nume);

class Produs { public string Nume = "Pix"; }
Corect
C#
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ă tu

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

Codul care dă eroarea
C#
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;
}
După reparație, programul afișează
Ana: 2
Mihai: negasit
Indiciu

Lista Note din clasa Elev nu e creată niciodată; iar FirstOrDefault poate întoarce null.

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, TryGetValue cu 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

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