JSON in classe C#

Esempio di output

Per input:

{ "firstName": "Alice", "age": 30, "emails": ["a@a.com"], "address": { "city": "Madrid" } }

Output di System.Text.Json (C# 10+):

public class User
{
    [JsonPropertyName("firstName")]
    public string FirstName { get; set; } = default!;

    [JsonPropertyName("age")]
    public int Age { get; set; }

    [JsonPropertyName("emails")]
    public List<string> Emails { get; set; } = new();

    [JsonPropertyName("address")]
    public Address Address { get; set; } = default!;
}

public class Address
{
    [JsonPropertyName("city")]
    public string City { get; set; } = default!;
}

Mappatura dei tipi

Opzioni di attributo

• System.Text.Json ([JsonPropertyName("foo")]), preferito per .NET 6+ e nuovi progetti.
• Newtonsoft.Json ([JsonProperty("foo")]), per progetti legacy o quando hai bisogno di funzionalità specifiche di Newtonsoft.
• Nessuno, i nomi delle proprietà corrispondono esattamente alle chiavi JSON (funziona solo se le chiavi JSON sono già in PascalCase).

Errori comuni

• Utilizzare int per un campo che potrebbe traboccare. Se il tuo JSON ha valori che superano int.MaxValue, usa long. Il generatore promuove automaticamente quando vede valori grandi.
• Mancanza di [JsonIgnore] per proprietà calcolate. Se aggiungi proprietà ausiliarie alla classe generata, decorale con [JsonIgnore] o verranno serializzate in uscita.
• Dimenticare l’analisi culturale-invariante. I campi decimal dovrebbero deserializzarsi con CultureInfo.InvariantCulture; System.Text.Json lo fa per impostazione predefinita, Newtonsoft con impostazioni globali.
• Fidarsi del generatore con un campione. La nullabilità e i tipi degli elementi degli array vengono indovinati da ciò che vede. Controlla sempre le annotazioni nullable rispetto al comportamento effettivo della tua API.