JSONからC#クラスへ

出力例

次の入力に対して：

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

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

型のマッピング

属性のオプション

• System.Text.Json（[JsonPropertyName("foo")]）. NET 6以降および新規プロジェクトに推奨されます。
• Newtonsoft.Json（[JsonProperty("foo")]）、レガシープロジェクトや、Newtonsoft固有の機能が必要な場合に使用します。
• なし、プロパティ名がJSONのキーと完全に一致します（JSONのキーが既にPascalCaseの場合にのみ有効です）。

よくある間違い

• オーバーフローの可能性があるフィールドにintを使う。 JSONにint.MaxValueを超える値が含まれる場合はlongを使います。ジェネレーターは大きな値を検出すると自動的に昇格します。
• 計算プロパティに[JsonIgnore]を付け忘れる。 生成されたクラスにヘルパープロパティを追加する場合は[JsonIgnore]を付けてください。付けないと出力時にシリアライズされてしまいます。
• カルチャー非依存のパースを忘れる。 decimalフィールドはCultureInfo.InvariantCultureでデシリアライズすべきです。System.Text.Jsonは既定でこれを行い、Newtonsoftはグローバル設定で行います。
• 1つのサンプルだけでジェネレーターを信頼する。 null許容性や配列要素の型は、与えられたデータから推測されます。null許容の注釈は、必ず実際のAPIの挙動と照らし合わせて確認してください。