🧩

Генератор C#‑классов из JSON

Преобразует JSON‑данные в строго типизированные C#‑классы с атрибутами JsonPropertyName, поддержкой nullable и аккуратным кодом.

Настройки
Имя класса
Имя корневого C#‑класса
Добавить JsonPropertyName
Сохраняет исходный ключ через JsonPropertyName("key")
Включить nullable‑ссылки
Автоматически добавляет ? если значение может быть null
Создавать частичный класс
Помечает все классы как partial для дальнейшего расширения

Введите JSON

Корректный JSON

❓Зачем конвертировать JSON в C#

REST API, облачные события, конфигурации и телеметрия поступают в формате JSON. Генерация строгих C#‑классов обеспечивает безопасность на этапе компиляции, более информативный IntelliSense и безопасный рефакторинг. JsonPropertyName сохраняет ключи без изменений и ускоряет согласование контрактов между командами.

✨Особенности

🚀

Сильная типизация

Автоматически подбирает подходящие C#‑типы, строит вложенные классы и сохраняет оригинальные ключи.
🧷

Поддержка JsonPropertyName

Гарантирует совместимость с System.Text.Json даже для snake_case.
🧮

Учёт nullable

Добавляет ? там, где JSON может вернуть null, фиксируя контракт данных.
📊

Статистика

Показывает количество классов, свойств и массивов сразу после генерации.

📚Практическое руководство

Маппинг JSON → C#

Строки преобразуются в string или DateTime, целые в long, дробные в double, логические в bool, объекты в отдельные классы, массивы в List<T>. При встрече с null свойство помечается как nullable и (если опция активна) получает суффикс ?. Смешанные массивы переводятся в List<object>, чтобы сохранить структуру.

Конвейер генерации

Конвертер рекурсивно обходит JSON, нормализует имена в PascalCase, избегает ключевых слов и переиспользует классы при одинаковой форме объектов. Статистика по количеству классов, свойств и массивов выводится сразу после генерации.

JsonPropertyName и сериализация

System.Text.Json полагается на JsonPropertyName, поэтому можно сохранить оригинальные ключи даже для snake_case и при этом обращаться к ним через PascalCase свойства. Классы создаются как partial, а значит кастомные проверки/конвертеры можно добавить в отдельных файлах.

Работа с nullable

При включённых nullable‑ссылках любой тип, который сталкивался с null (bool, long, double, string, List<T>, дочерние классы), автоматически получает ?. Это переносит контроль на компилятор и уменьшает вероятность NullReferenceException.

💬Frequently Asked Questions

❓Что такое генерация классов C# из JSON и почему это полезно?
Генерация классов C# из JSON автоматически создаёт строго типизированные классы C# из структур данных JSON. Это необходимо при работе с API, файлами конфигурации или сериализацией данных в приложениях .NET. Вместо ручного написания классов или использования динамических типов генератор создаёт правильные классы C# с корректными типами, поддержкой nullable и атрибутами JsonPropertyName, экономя часы разработки и уменьшая ошибки.
💬Как генератор обрабатывает различные типы данных JSON?
Генератор сопоставляет типы JSON с соответствующими типами C#: строки становятся string или DateTime (для дат ISO-8601), целые числа сопоставляются с long, числа с плавающей точкой с double, булевы значения с bool, объекты становятся выделенными классами, а массивы становятся List<T>. Значения null помечают свойства как nullable (с суффиксом ? при включённых nullable-ссылках). Смешанные массивы используют List<object> для сохранения разнородных данных.
🔍Что такое атрибуты JsonPropertyName и когда их следует использовать?
Атрибуты JsonPropertyName позволяют свойствам C# использовать именование PascalCase (соглашение C#), в то время как JSON использует другое именование (например, snake_case или camelCase). Атрибут сохраняет исходное имя ключа JSON во время сериализации/десериализации. Включите эту опцию, когда ваш JSON использует ключи не в PascalCase, но вы хотите использовать идиоматические имена свойств C# в вашем коде.
💡Что такое поддержка nullable-ссылок и зачем её включать?
Nullable-ссылочные типы (C# 8.0+) добавляют ? к ссылочным типам, когда они могут быть null, включая проверку null на этапе компиляции. При включении генератор добавляет ? к свойствам, когда образец JSON содержит значения null. Это помогает предотвратить ошибки NullReferenceException, делает необязательные поля явными и следует современным практикам C# для безопасности null.
📚Могу ли я изменить сгенерированные классы после генерации?
Да, генератор по умолчанию создаёт частичные классы (или при включении), позволяя расширять их в отдельных файлах без изменения сгенерированного кода. Вы можете добавлять пользовательские методы, логику валидации, атрибуты предметной области или реализовывать интерфейсы. Это разделение сохраняет сгенерированный код чистым и позволяет безопасно регенерировать классы при изменении структуры JSON.

💡Рекомендации

💡

Используйте репрезентативные данные

Добавляйте опциональные секции и null, чтобы генератор правильно выставил nullable.
🧱

Делите огромные payload

Конвертируйте крупные ответы по частям и объединяйте через partial class.
🧾

Очищайте JSON

Удалите комментарии и лишние запятые, чтобы парсер не падал.

📝Журнал изменений

📌v1.0.251115
v1.0.251115

Первый релиз: переключатель JsonPropertyName, обработка nullable, статистика и экспорт .cs

📦Рекомендуемые пакеты

User Comments

0 / 2000
Loading...