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

System.InvalidOperationException: Nullable object must have a value.

Pe scurt

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

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

Un tip valoare nullable, scris int? (adică Nullable<int>), poate ține un număr sau poate fi null, ceea ce e util pentru valori care pot lipsi: o notă încă neintrodusă, o dată de livrare necunoscută. Proprietatea .Value întoarce numărul din interior, dar numai dacă există. Dacă variabila e null, .Value aruncă InvalidOperationException cu mesajul „Nullable object must have a value” („obiectul nullable trebuie să aibă o valoare”).

Aceeași excepție apare și la cast-ul explicit (int)stoc când stoc e null, pentru că cast-ul apelează .Value în spate. Stack trace-ul arată System.Nullable1.get_Value()` și linia ta.

Cauzele obișnuite: o valoare care „de obicei” există și pe care o folosești fără verificare; un rezultat nullable al unei metode LINQ (Max() pe o listă de int? goală întoarce null); sau câmpuri dintr-o bază de date ori dintr-un JSON care pot lipsi. Excepția apare doar la tipurile valoare nullable; la referințe null primești NullReferenceException.

De ce apare: cauzele frecvente

1.Value fără verificare

Greșit
C#
int? stoc = null;
int s = stoc.Value;
Corect
C#
int? stoc = null;
int s = stoc ?? 0;

?? întoarce 0 când stoc e null, în loc să arunce excepție.

2Cast explicit dintr-un nullable

Greșit
C#
decimal? reducere = null;
decimal r = (decimal)reducere;
Corect
C#
decimal? reducere = null;
decimal r = reducere.GetValueOrDefault();

Cast-ul (decimal) apelează intern .Value. GetValueOrDefault() întoarce 0 când lipsește valoarea.

3Ramuri diferite pentru valoare lipsă

Greșit
C#
int? nota = null;
Console.WriteLine($"Nota: {nota.Value}");
Corect
C#
int? nota = null;
if (nota.HasValue)
    Console.WriteLine($"Nota: {nota.Value}");
else
    Console.WriteLine("Nota: nedefinita");

HasValue spune dacă există valoare; în ramura true, .Value e sigur.

Repară tu

Repară eroarea, direct în pagină

Programul afișează media finală a unor studenți, dar unii nu au încă nota la examen (null), iar la rulare primești System.InvalidOperationException: Nullable object must have a value. Repară afișarea, astfel încât pentru notele lipsă să apară „in asteptare”.

Codul care dă eroarea
C#
var studenti = new List<Student>
{
    new Student("Ana", 9),
    new Student("Dan", null),
    new Student("Ioana", 7)
};

foreach (var s in studenti)
    Console.WriteLine($"{s.Nume}: {s.Nota.Value}");

record Student(string Nume, int? Nota);
După reparație, programul afișează
Ana: 9
Dan: in asteptare
Ioana: 7
Indiciu

Verifică s.Nota.HasValue înainte să folosești s.Nota.Value.

Alte forme ale mesajului

  • Unhandled exception. System.InvalidOperationException: Nullable object must have a value.

Cum o eviți pe viitor

  • Nu folosi .Value decât după HasValue sau într-un if (x is int v).
  • Preferă x ?? valoareImplicita și x.GetValueOrDefault() când există o valoare implicită care are sens.
  • Afișează valorile lipsă explicit (x?.ToString() ?? "-"), ca să nu le confunzi cu 0.
  • Gândește-te de la început dacă o valoare poate lipsi; dacă nu, nu o declara nullable.

Întrebări frecvente

De ce nu primesc NullReferenceException?

Pentru că int? este un struct (Nullable<int>), nu o referință. „Null” înseamnă aici HasValue == false, iar accesul la .Value aruncă InvalidOperationException.

Cum aleg între ?? 0 și HasValue?

Folosește ?? 0 când 0 e o valoare implicită corectă (de exemplu stoc necunoscut tratat ca 0). Folosește HasValue când lipsa valorii trebuie tratată diferit (de exemplu „nota nu a fost introdusă”).

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.