JSON para Classe C#

Exemplo de saída

Para entrada:

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

Saída do 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!;
}

Mapeamento de tipos

Opções de atributo

• System.Text.Json ([JsonPropertyName("foo")]), preferido para .NET 6+ e novos projetos.
• Newtonsoft.Json ([JsonProperty("foo")]), para projetos legados ou quando você precisa de recursos específicos do Newtonsoft.
• Nenhum, nomes de propriedades correspondem exatamente às chaves JSON (funciona apenas se as chaves JSON já estiverem em PascalCase).

Erros comuns

• Usar int para um campo que pode transbordar. Se seu JSON tiver valores que excedem int.MaxValue, use long. O gerador promove automaticamente quando vê valores grandes.
• Faltando [JsonIgnore] para propriedades computadas. Se você adicionar propriedades auxiliares à classe gerada, decore-as com [JsonIgnore] ou elas serão serializadas na saída.
• Esquecendo a análise independente de cultura. Campos decimal devem ser desserializados com CultureInfo.InvariantCulture; System.Text.Json faz isso por padrão, Newtonsoft com configurações globais.
• Confiando no gerador com um único exemplo. A nulidade e os tipos de itens de array são adivinhados a partir do que ele vê. Sempre verifique as anotações anuláveis em relação ao comportamento real da sua API.