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, через глобальные настройки.
• Доверие генератору по одному образцу. Nullability и типы элементов массива определяются по тому, что генератор видит. Всегда сверяйте nullable-аннотации с реальным поведением вашего API.