Converte JSON em classes C# para o System.Text.Json. Os nomes das propriedades viram PascalCase, e cada propriedade leva um atributo [JsonPropertyName] para fazer o bind com a chave original exata.
Poupa o trabalho de copiar e digitar models de request e response no ASP.NET Core, tipos para chamadas HttpClient.GetFromJsonAsync<T>() a APIs externas e classes de dados em apps Unity ou MAUI.
Nome do tipo (por exemplo PaymentResult)..cs e adicione o seu namespace.JsonSerializer.Deserialize<PaymentResult>(json) ou 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;
}
Toda propriedade tem [JsonPropertyName], então paymentId ↔ PaymentId bate independentemente das regras de case. metadata só aparece como null, então o tipo é desconhecido e ela vira JsonElement?. Propriedades string e objeto recebem os inicializadores string.Empty / new() para o código compilar sem warnings de nullable.
[JsonPropertyName("originalKey")] em cada propriedade, com using System.Text.Json.Serialization;.string, int, long para inteiros acima de 32 bits, double para decimais, bool e List<T> para arrays.JsonElement, adicionando using System.Text.Json;.null viram nullable (int?, string?).= string.Empty; ou = new(); para evitar o warning de nullable reference CS8618.Value (ex.: RootValue).// Root: List<RootItem> e a classe do elemento.Converta uma resposta de exemplo de uma API de pagamento ou de rastreamento de entregas e use como tipo em await http.GetFromJsonAsync<PaymentResult>(url), em vez de tirar os campos um a um de um JsonDocument.
Gere classes a partir do payload que um serviço de terceiros manda para você e receba como parâmetro [FromBody], para que o model binding e a validação funcionem normalmente.
Fixar em classes a estrutura de um arquivo JSON de dados lido por um app Unity ou console faz com que uma mudança no arquivo apareça na hora como erro de desserialização.
[JsonProperty]). Se você usa Json.NET, troque os atributos por [JsonProperty("key")].string. Para valores ISO 8601, trocar o tipo para DateTime ou DateTimeOffset basta para o System.Text.Json fazer o parse.new() target-typed e o string? pressupõem C# 9+ com o contexto nullable ativado (o padrão desde o .NET 6).record ou required. Para models imutáveis, troque { get; set; } por { get; init; }.[JsonPropertyName] mesmo quando a chave já bate?O System.Text.Json diferencia maiúsculas de minúsculas por padrão. Em projetos console ou worker sem JsonSerializerOptions customizado, paymentId não faria bind com PaymentId, então o atributo é sempre escrito para funcionar independente da configuração.
JsonElement??Confira o ValueKind e depois use GetString(), GetInt32() ou Deserialize<T>(). Quando você souber o tipo real, trocar o JsonElement por ele é a opção mais limpa.
A saída segue a convenção PascalCase do C#. A chave original fica no [JsonPropertyName], então você pode renomear as propriedades à vontade desde que o atributo permaneça.
O JsonUtility só trata campos públicos de classes [Serializable], não propriedades, e ignora o [JsonPropertyName]. No Unity, combine a saída com o pacote Newtonsoft.Json ou com o System.Text.Json.