Convierte JSON en clases C# para System.Text.Json. Los nombres de propiedad pasan a PascalCase, y cada propiedad lleva un atributo [JsonPropertyName] para que se vincule exactamente a la clave original.
Te ahorra copiar y teclear los modelos de petición y respuesta de ASP.NET Core, los tipos para llamadas HttpClient.GetFromJsonAsync<T>() a APIs externas y las clases de datos en apps de Unity o MAUI.
Nombre del tipo (por ejemplo PaymentResult)..cs y añade tu namespace.JsonSerializer.Deserialize<PaymentResult>(json) o GetFromJsonAsync<PaymentResult>(url).{
"paymentId": "pay_8f2k",
"amount": 15000,
"currency": "KRW",
"approved": true,
"approvedAt": "2024-05-01T12:30:00Z",
"card": { "issuer": "VISA", "last4": "4242" },
"metadata": null
}using System.Collections.Generic;
using System.Text.Json;
using System.Text.Json.Serialization;
public class PaymentResult
{
[JsonPropertyName("paymentId")]
public string PaymentId { get; set; } = string.Empty;
[JsonPropertyName("amount")]
public int Amount { get; set; }
[JsonPropertyName("currency")]
public string Currency { get; set; } = string.Empty;
[JsonPropertyName("approved")]
public bool Approved { get; set; }
[JsonPropertyName("approvedAt")]
public string ApprovedAt { get; set; } = string.Empty;
[JsonPropertyName("card")]
public Card Card { get; set; } = new();
[JsonPropertyName("metadata")]
public JsonElement? Metadata { get; set; }
}
public class Card
{
[JsonPropertyName("issuer")]
public string Issuer { get; set; } = string.Empty;
[JsonPropertyName("last4")]
public string Last4 { get; set; } = string.Empty;
}
Todas las propiedades tienen [JsonPropertyName], así que paymentId ↔ PaymentId coinciden sin importar las reglas de mayúsculas. metadata solo vale null, así que su tipo es desconocido y pasa a JsonElement?. Las propiedades de cadena y de objeto reciben inicializadores string.Empty / new() para que el código compile sin advertencias de nullable.
[JsonPropertyName("originalKey")] en cada propiedad, con using System.Text.Json.Serialization;.string, int, long para enteros de más de 32 bits, double para decimales, bool y List<T> para arrays.JsonElement, y se añade using System.Text.Json;.null pasan a ser nullable (int?, string?).= string.Empty; o = new(); para evitar la advertencia CS8618 de tipos de referencia nullable.Value (p. ej. RootValue).// Root: List<RootItem> y la clase del elemento.Convierte una respuesta de ejemplo de una API de pagos o de seguimiento de envíos y úsala como tipo en await http.GetFromJsonAsync<PaymentResult>(url), en lugar de sacar los campos uno a uno de un JsonDocument.
Genera clases a partir del payload que te envía un servicio de terceros y recíbelo como parámetro [FromBody], para que el model binding y la validación funcionen como siempre.
Fijar en clases la estructura de un archivo de datos JSON que lee una app de Unity o de consola hace que un cambio en el archivo aparezca enseguida como error de deserialización.
[JsonProperty]). Si usas Json.NET, cambia los atributos a [JsonProperty("key")].string. Para valores ISO 8601, basta con cambiar el tipo a DateTime o DateTimeOffset para que System.Text.Json los parsee.new() con tipo de destino y string? suponen C# 9+ con el contexto nullable activado (el valor por defecto desde .NET 6).record ni required. Para modelos inmutables, cambia { get; set; } por { get; init; }.[JsonPropertyName] aunque la clave ya coincida?System.Text.Json distingue mayúsculas por defecto. En proyectos de consola o worker sin JsonSerializerOptions personalizadas, paymentId no se vincularía a PaymentId, así que el atributo se escribe siempre para que funcione con cualquier configuración.
JsonElement??Comprueba ValueKind y luego usa GetString(), GetInt32() o Deserialize<T>(). Cuando conozcas el tipo real, sustituir JsonElement por él es la opción más limpia.
La salida sigue la convención PascalCase de C#. La clave original está en [JsonPropertyName], así que puedes renombrar las propiedades libremente mientras el atributo se mantenga.
JsonUtility solo maneja campos públicos de clases [Serializable], no propiedades, e ignora [JsonPropertyName]. En Unity, combina la salida con el paquete Newtonsoft.Json o con System.Text.Json.