JSON a Clase C#

Ejemplo de salida

Para la entrada:

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

Salida de 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!;
}

Mapeo de tipos

Opciones de atributos

• System.Text.Json ([JsonPropertyName("foo")]), preferido para .NET 6+ y nuevos proyectos.
• Newtonsoft.Json ([JsonProperty("foo")]), para proyectos heredados o cuando necesitas características específicas de Newtonsoft.
• Ninguno, los nombres de las propiedades coinciden exactamente con las claves JSON (funciona solo si las claves JSON ya están en PascalCase).

Errores comunes

• Usar int para un campo que podría desbordarse. Si tu JSON tiene valores que superan int.MaxValue, usa long. El generador promueve automáticamente cuando ve valores grandes.
• Faltar [JsonIgnore] para propiedades computadas. Si agregas propiedades auxiliares a la clase generada, decóralas con [JsonIgnore] o se serializarán al salir.
• Olvidar el análisis independiente de la cultura. Los campos decimal deben deserializarse con CultureInfo.InvariantCulture; System.Text.Json lo hace por defecto, Newtonsoft con configuraciones globales.
• Confiar en el generador con un solo ejemplo. La nulabilidad y los tipos de elementos de arreglos se adivinan de lo que ve. Siempre verifica las anotaciones anulables contra el comportamiento real de tu API.