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()`.
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
int? stoc = null;
int s = stoc.Value;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
decimal? reducere = null;
decimal r = (decimal)reducere;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ă
int? nota = null;
Console.WriteLine($"Nota: {nota.Value}");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ă 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”.
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);Ana: 9 Dan: in asteptare Ioana: 7
Indiciu
Verifică s.Nota.HasValue înainte să folosești s.Nota.Value.
Reparația
var studenti = new List<Student>
{
new Student("Ana", 9),
new Student("Dan", null),
new Student("Ioana", 7)
};
foreach (var s in studenti)
{
string text = s.Nota.HasValue ? s.Nota.Value.ToString() : "in asteptare";
Console.WriteLine($"{s.Nume}: {text}");
}
record Student(string Nume, int? Nota);De ce merge
Nota este int?, iar pentru Dan este null. Accesul la .Value pe un nullable fără valoare aruncă InvalidOperationException. Verificarea HasValue desparte cele două cazuri: dacă nota există, .Value e sigur și se afișează; altfel se afișează „in asteptare”. Așa lipsa valorii e tratată explicit, nu înlocuită pe ascuns cu un 0 care ar putea fi luat drept notă reală.
Alte forme ale mesajului
Unhandled exception. System.InvalidOperationException: Nullable object must have a value.
Cum o eviți pe viitor
- Nu folosi
.Valuedecât dupăHasValuesau într-unif (x is int v). - Preferă
x ?? valoareImplicitașix.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
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.InvalidOperationException: Sequence contains no elements Ai apelat o metodă LINQ care are nevoie de cel puțin un element (`Max`, `Min`, `Average`, `First`, `Last`, `Single`) pe o colecție goală. Verifică înainte cu `Any()` sau folosește variantele sigure: `FirstOrDefault`, `DefaultIfEmpty(0).Max()`, `MaxBy` cu verificare. 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.
