I-convert ang JSON sa mga C# class para sa System.Text.Json. Ginagawang PascalCase ang mga property name, at may [JsonPropertyName] attribute ang bawat property para mag-bind ito sa eksaktong orihinal na key.
Hindi mo na kailangang kumopya at mag-type nang mano-mano para sa mga ASP.NET Core request at response model, mga type para sa mga HttpClient.GetFromJsonAsync<T>() call sa external API, at mga data class sa Unity o MAUI app.
Pangalan ng type ang pangalan ng root class (halimbawa PaymentResult)..cs file at idagdag ang namespace mo.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;
}
May [JsonPropertyName] ang bawat property, kaya tugma ang paymentId ↔ PaymentId anuman ang casing rules. Laging null lang ang metadata, kaya hindi alam ang type nito at nagiging JsonElement?. May initializer na string.Empty / new() ang mga string at object property para mag-compile ang code nang walang nullable warning.
[JsonPropertyName("originalKey")] sa bawat property, kasama ang using System.Text.Json.Serialization;.string, int, long para sa mga integer na lampas sa 32 bits, double para sa decimal, bool, at List<T> para sa mga array.JsonElement ang mga value na halo o hindi alam ang type, at idinadagdag ang using System.Text.Json;.int?, string?) ang mga property na wala sa ilang item o may laman na null.= string.Empty; o = new(); ang mga required na property para maiwasan ang nullable reference warning na CS8618.Value (hal. RootValue).// Root: List<RootItem> at ang class ng element.I-convert ang isang sample response mula sa payment o shipment-tracking API at gamitin ito bilang type sa await http.GetFromJsonAsync<PaymentResult>(url), sa halip na isa-isang kunin ang mga field mula sa isang JsonDocument.
Gumawa ng mga class mula sa payload na ipinapadala sa iyo ng isang third-party service at tanggapin sila bilang [FromBody] parameter, para gumana gaya ng dati ang model binding at validation.
Kapag naka-pin sa mga class ang istruktura ng JSON data file na binabasa ng isang Unity o console app, agad na lumalabas bilang deserialization error ang nagbagong data file.
[JsonProperty]). Kung Json.NET ang gamit mo, palitan ang mga attribute ng [JsonProperty("key")].string ang mga date string. Para sa mga ISO 8601 value, sapat nang palitan ang type ng DateTime o DateTimeOffset para ma-parse sila ng System.Text.Json.new() at string? ang C# 9+ na naka-enable ang nullable context (default mula .NET 6).record o required. Para sa mga immutable model, palitan ang { get; set; } ng { get; init; }.[JsonPropertyName] kahit tugma na ang key?Case-sensitive ang System.Text.Json bilang default. Sa mga console o worker project na walang custom na JsonSerializerOptions, hindi magba-bind ang paymentId sa PaymentId, kaya laging isinusulat ang attribute para gumana anuman ang configuration.
JsonElement? property?I-check ang ValueKind, saka gamitin ang GetString(), GetInt32() o Deserialize<T>(). Kapag alam mo na ang totoong type, mas malinis na palitan ang JsonElement nito.
Sinusunod ng output ang PascalCase convention ng C#. Nasa [JsonPropertyName] ang orihinal na key, kaya malaya mong mapapalitan ang pangalan ng mga property basta't nandoon pa rin ang attribute.
Mga public field lang ng mga [Serializable] class ang hinahawakan ng JsonUtility, hindi mga property, at hindi nito pinapansin ang [JsonPropertyName]. Sa Unity, ipares ang output sa Newtonsoft.Json package o sa System.Text.Json.