...
Eroare C# · Fișiere, HTTP, URI și JSON

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.

Pe scurt

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

Greșit
C#
class Produs
{
    public string Nume { get; }
    public Produs(string denumire) { Nume = denumire; }
}
Corect
C#
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

Greșit
C#
class Comanda
{
    public decimal Total { get; }
    public Comanda(decimal pret, int cantitate) { Total = pret * cantitate; }
}
Corect
C#
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

Greșit
C#
class Elev
{
    public string Nume { get; }
    public Elev(string n) { Nume = n; }
}
Corect
C#
record Elev(string Nume);

La record-uri, parametrii constructorului și proprietățile au automat același nume.

Repară tu

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.

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

Compară numele parametrilor constructorului cu numele proprietăților.

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

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