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

System.Text.Json.JsonException: The JSON value could not be converted to System.Int32. Path: $.Varsta | LineNumber: 0 | BytePositionInLine: 27.

Pe scurt

JSON-ul e valid, dar o valoare nu se potrivește cu tipul proprietății din clasa ta. `Path: $.Varsta` arată proprietatea: de exemplu numărul vine ca text (`"17"`) sau un obiect vine în loc de listă. Schimbă tipul proprietății sau activează `NumberHandling = JsonNumberHandling.AllowReadingFromString`.

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

Ce înseamnă

Spre deosebire de „invalid start of a value”, aici textul e JSON corect. Problema e la potrivirea cu clasa C#: System.Text.Json a citit valoarea de la calea indicată ($.Varsta = proprietatea Varsta de la rădăcină; $.Produse[2].Pret = prețul celui de-al treilea produs) și nu a putut-o transforma în tipul cerut (System.Int32, System.Decimal, System.DateTime, List1[...]`).

Cauze frecvente:

  • numere trimise ca texte ("Varsta": "17"); System.Text.Json nu le convertește implicit, spre deosebire de Newtonsoft.Json;
  • o valoare null pentru o proprietate int/decimal, care nu acceptă null;
  • un singur obiect sau text acolo unde clasa așteaptă o listă;
  • date în alt format decât ISO 8601 ("01.02.2026" pentru DateTime);
  • enum-uri trimise ca text fără JsonStringEnumConverter.

Excepția internă (---> System.InvalidOperationException: Cannot get the value of a token type 'String' as a number.) îți spune tipul găsit de fapt.

De ce apare: cauzele frecvente

1Număr trimis ca text

Greșit
C#
using System.Text.Json;
var e = JsonSerializer.Deserialize<Elev>("{\"Varsta\":\"17\"}");
class Elev { public int Varsta { get; set; } }
Corect
C#
using System.Text.Json;
using System.Text.Json.Serialization;
var opt = new JsonSerializerOptions { NumberHandling = JsonNumberHandling.AllowReadingFromString };
var e = JsonSerializer.Deserialize<Elev>("{\"Varsta\":\"17\"}", opt);
class Elev { public int Varsta { get; set; } }

Opțiunea permite citirea numerelor scrise între ghilimele.

2null pentru un tip valoare

Greșit
C#
using System.Text.Json;
var p = JsonSerializer.Deserialize<Produs>("{\"Stoc\":null}");
class Produs { public int Stoc { get; set; } }
Corect
C#
using System.Text.Json;
var p = JsonSerializer.Deserialize<Produs>("{\"Stoc\":null}");
class Produs { public int? Stoc { get; set; } }

Un int nu poate fi null. Cu int?, valoarea lipsă e acceptată.

3Un singur text în loc de listă

Greșit
C#
using System.Text.Json;
var a = JsonSerializer.Deserialize<Articol>("{\"Tags\":\"csharp\"}");
class Articol { public List<string> Tags { get; set; } }
Corect
C#
using System.Text.Json;
var a = JsonSerializer.Deserialize<Articol>("{\"Tags\":[\"csharp\"]}");
class Articol { public List<string> Tags { get; set; } }

Lista trebuie să vină ca tablou JSON ([...]). Dacă nu controlezi sursa, scrie un convertor propriu.

Repară tu

Repară eroarea, direct în pagină

Un API trimite prețurile produselor ca texte ("Pret":"12.50"), iar programul se oprește cu System.Text.Json.JsonException: The JSON value could not be converted to System.Decimal. Path: $[0].Pret. Fără să schimbi JSON-ul sau tipul decimal, configurează deserializarea, astfel încât programul să afișeze fiecare produs și totalul.

Codul care dă eroarea
C#
using System.Text.Json;
using System.Text.Json.Serialization;

string json = "[{\"Nume\":\"Mouse\",\"Pret\":\"12.50\"},{\"Nume\":\"Pad\",\"Pret\":\"7.25\"}]";
var produse = JsonSerializer.Deserialize<List<Produs>>(json);
foreach (var p in produse)
    Console.WriteLine($"{p.Nume}: {p.Pret:F2}");
Console.WriteLine($"Total: {produse.Sum(p => p.Pret):F2}");

class Produs
{
    public string Nume { get; set; }
    public decimal Pret { get; set; }
}
După reparație, programul afișează
Mouse: 12.50
Pad: 7.25
Total: 19.75
Indiciu

JsonSerializerOptions are o setare NumberHandling pentru numere scrise între ghilimele.

Alte forme ale mesajului

  • System.Text.Json.JsonException: The JSON value could not be converted to System.Decimal. Path: $.Pret | LineNumber: 0 | BytePositionInLine: 16.
  • System.Text.Json.JsonException: The JSON value could not be converted to System.Collections.Generic.List`1[System.String]. Path: $.Tags | LineNumber: 0 | BytePositionInLine: 12.

Cum o eviți pe viitor

  • Pune tipurile proprietăților după formatul real al datelor; dacă sursa trimite numere ca text, folosește JsonNumberHandling.AllowReadingFromString.
  • Folosește tipuri nullable (int?, DateTime?) pentru câmpurile care pot lipsi.
  • Pentru enum-uri ca text, adaugă new JsonStringEnumConverter() în Converters.
  • Ține un exemplu real de răspuns JSON lângă clasă și testează deserializarea pe el.

Întrebări frecvente

De ce cu Newtonsoft.Json mergea?

Newtonsoft.Json convertește implicit multe valori (de exemplu "17" în int). System.Text.Json e strict în mod implicit; flexibilitatea se activează prin opțiuni.

Cum citesc Path?

$ este rădăcina documentului, .Nume o proprietate, [2] al treilea element dintr-un tablou. $.Comenzi[0].Total = totalul primei comenzi.

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.