System.InvalidOperationException: Each parameter in the deserialization constructor on type 'Produs' must bind to an object property or field on deserialization. Each parameter name must match with a property or field on the object. Fields are only considered when 'JsonSerializerOptions.IncludeFields' is enabled. The match can be case-insensitive.
Constructorul folosit la deserializare are un parametru al cărui nume nu corespunde niciunei proprietăți a clasei (de exemplu parametrul `denumire` pentru proprietatea `Nume`). Redenumește parametrul exact ca proprietatea (`nume` pentru `Nume`; majusculele nu contează) sau adaugă proprietatea lipsă.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Când System.Text.Json creează un obiect printr-un constructor cu parametri, potrivește fiecare parametru cu o proprietate (sau câmp, dacă IncludeFields e activ) a clasei, după nume. Numele trebuie să fie același, doar majusculele pot diferi: parametrul nume se potrivește cu proprietatea Nume.
Dacă un parametru nu are pereche (denumire când proprietatea e Nume, cantitate când proprietatea e Stoc), serializatorul nu știe din ce câmp să-l completeze și aruncă InvalidOperationException: Each parameter in the deserialization constructor on type 'Produs' must bind to an object property or field on deserialization....
Eroarea apare chiar dacă JSON-ul conține toate datele: regula verifică clasa, nu JSON-ul. De aceea apare și la clasele care merg perfect în codul normal, dar sunt folosite pentru prima dată cu JSON.
Reparația: numele parametrului = numele proprietății. Pentru record-urile poziționale (record Produs(string Nume, decimal Pret)) potrivirea e automată.
De ce apare: cauzele frecvente
1Parametru cu alt nume decât proprietatea
class Produs
{
public string Nume { get; }
public Produs(string denumire) { Nume = denumire; }
}class Produs
{
public string Nume { get; }
public Produs(string nume) { Nume = nume; }
}Parametrul nume se potrivește cu proprietatea Nume, deci serializatorul știe ce valoare să-i dea.
2Parametru fără proprietate corespunzătoare
class Comanda
{
public decimal Total { get; }
public Comanda(decimal pret, int cantitate) { Total = pret * cantitate; }
}class Comanda
{
public decimal Pret { get; }
public int Cantitate { get; }
public decimal Total => Pret * Cantitate;
public Comanda(decimal pret, int cantitate) { Pret = pret; Cantitate = cantitate; }
}Fiecare parametru trebuie să aibă o proprietate cu același nume. Valorile calculate devin proprietăți fără parametru.
3Folosește un record
class Elev
{
public string Nume { get; }
public Elev(string n) { Nume = n; }
}record Elev(string Nume);La record-uri, parametrii constructorului și proprietățile au automat același nume.
Repară eroarea, direct în pagină
Programul citește un client din JSON prin constructorul clasei, dar se oprește cu System.InvalidOperationException: Each parameter in the deserialization constructor on type 'Client' must bind to an object property or field on deserialization.... Repară constructorul ca programul să afișeze Ana Pop, 3 comenzi.
using System.Text.Json;
string json = "{\"Nume\":\"Ana Pop\",\"Comenzi\":3}";
var c = JsonSerializer.Deserialize<Client>(json);
Console.WriteLine($"{c.Nume}, {c.Comenzi} comenzi");
class Client
{
public string Nume { get; }
public int Comenzi { get; }
public Client(string numeComplet, int comenzi)
{
Nume = numeComplet;
Comenzi = comenzi;
}
}Ana Pop, 3 comenzi
Indiciu
Compară numele parametrilor constructorului cu numele proprietăților.
Reparația
using System.Text.Json;
string json = "{\"Nume\":\"Ana Pop\",\"Comenzi\":3}";
var c = JsonSerializer.Deserialize<Client>(json);
Console.WriteLine($"{c.Nume}, {c.Comenzi} comenzi");
class Client
{
public string Nume { get; }
public int Comenzi { get; }
public Client(string nume, int comenzi)
{
Nume = nume;
Comenzi = comenzi;
}
}De ce merge
Serializatorul potrivește fiecare parametru al constructorului cu o proprietate a clasei, după nume. Parametrul numeComplet nu avea nicio proprietate cu același nume, deci obiectul nu putea fi construit. Cu parametrii nume și comenzi, potrivirea cu Nume și Comenzi reușește (majusculele nu contează), iar valorile din JSON ajung în constructor.
Alte forme ale mesajului
System.InvalidOperationException: Each parameter in the deserialization constructor on type 'Produs' must bind to an object property or field on deserialization. Each parameter name must match with a property or field on the object. Fields are only considered when 'JsonSerializerOptions.IncludeFields' is set to true. The match can be case-insensitive.
Cum o eviți pe viitor
- Numește parametrii constructorilor exact ca proprietățile, cu literă mică:
Nume->nume. - Pentru obiecte de transfer (DTO), folosește record-uri poziționale.
- Când redenumești o proprietate, folosește Rename din editor, care schimbă și parametrul din constructor dacă ai ales același nume.
- Scrie un test mic care deserializează un exemplu de JSON pentru fiecare clasă folosită în API.
Întrebări frecvente
JSON-ul are câmpul, de ce primesc totuși eroarea?
Pentru că verificarea se face pe clasă: serializatorul cere ca fiecare parametru al constructorului să corespundă unei proprietăți a clasei. Numele din JSON contează abia după aceea.
Pot folosi alt nume în JSON decât în C#?
Da: pune [JsonPropertyName("denumire")] pe proprietatea Nume și păstrează parametrul nume. Legătura parametru-proprietate rămâne după numele din C#.
Erori înrudite
System.NotSupportedException: Deserialization of types without a parameterless constructor, a singular parameterized constructor, or a parameterized constructor annotated with 'JsonConstructorAttribute' is not supported. Type 'Produs'. Path: $ | LineNumber: 0 | BytePositionInLine: 1. `System.Text.Json` nu știe cum să creeze obiectul: clasa nu are constructor fără parametri și are mai mulți constructori cu parametri. Adaugă un constructor public fără parametri sau marchează constructorul de folosit cu `[JsonConstructor]`. System.Text.Json.JsonException: JSON deserialization for type 'Produs' was missing required properties including: 'Nume'. Clasa are proprietăți marcate `required` (sau `[JsonRequired]`), iar JSON-ul primit nu le conține, cel mai des pentru că numele diferă (`nume` vs `Nume`). Activează `PropertyNameCaseInsensitive = true` (sau `JsonSerializerDefaults.Web`), pune `[JsonPropertyName("nume")]` ori verifică de ce câmpul lipsește din date. System.Text.Json.JsonException: The JSON value could not be converted to System.Int32. Path: $.Varsta | LineNumber: 0 | BytePositionInLine: 27. 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`. Î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.
