🧩

JSON→C# クラス生成ツール

JSON ペイロードから強い型付けの C# クラスを生成し、JsonPropertyName 属性・nullable 参照・整ったコードを自動で付与します。

実用ガイド
設定
クラス名
生成されるルート C# クラスの名前
JsonPropertyName を付与
JsonPropertyName("key") を出力し元の JSON キーを保持
nullable 参照を有効化
JSON に null が含まれる場合、自動で ? を付加
partial class を生成
全クラスを partial にし、別ファイルでの拡張を容易にします

JSON を入力

有効な JSON

❓JSON を C# に変換する意義

REST API・クラウドイベント・設定ファイル・テレメトリなど、.NET が扱う多くのデータは JSON です。サンプルを強型付けされた C# クラスに変換すれば、コンパイル時安全性が向上し、IntelliSense も充実し、リファクタリングも安全になります。JsonPropertyName によりオリジナルのキーを維持でき、チーム間での契約共有も迅速です。

✨主な機能

🚀

強固な型付け

C# に最適化された型と入れ子クラスを自動生成し、元の JSON キーを忠実に再現します。
🧷

JsonPropertyName 対応

snake_case の JSON でも System.Text.Json で確実にデシリアライズできるよう属性を付与。
🧮

nullable 対応

サンプルに null があれば即座に ? を付け、必要な null チェックを明示します。
📊

生成統計

クラス・プロパティ・配列の件数を表示し、モデルの複雑さを把握。

📚実用ガイド

JSON→C# 型マッピング

文字列は string または ISO-8601 なら DateTime、整数は long、小数を含む数値は double、真偽値は bool、オブジェクトは専用クラス、配列は List<T> に変換します。サンプルに null があれば可空扱いとなり、nullable を有効化すると ? が付与されます。異種混合の配列は List<object> にフォールバックし、どんなペイロードでも安全に表現できます。

クラス生成パイプライン

再帰的に JSON を走査し、同じ形状のオブジェクトを識別してクラス定義を再利用します。プロパティ名は PascalCase に正規化し、C# の予約語を避けます。配列は推論された要素型を共有するため、冗長なクラスが増えません。変換結果にはクラス数・プロパティ数・配列数が表示され、構造の複雑さを一目で把握できます。

JsonPropertyName とシリアライゼーション

System.Text.Json は JsonPropertyName 属性を参照してキーを解決するため、snake_case のペイロードでも PascalCase のプロパティで扱えます。生成されたクラスは partial なので、ドメイン固有の検証やコンバーターを別ファイルで追加しても自動生成コードを壊しません。

nullable 参照戦略

nullable 参照型をオンにすると、サンプルに null が含まれる値型(bool/long/double など)も参照型(string/List<T>/入れ子クラス)も自動的に ? 付きになります。コンパイラが null チェックを強制するため、ランタイムの NullReferenceException を未然に防げます。

💬Frequently Asked Questions

❓JSONからC#クラス生成とは何ですか?なぜ有用ですか?
JSONからC#クラス生成は、JSONデータ構造から強く型付けされたC#クラスを自動的に作成します。これは、.NETアプリケーションでAPI、設定ファイル、またはデータシリアル化を操作する際に不可欠です。クラスを手動で記述したり、動的型を使用したりする代わりに、ジェネレーターは正しい型、null許容サポート、JsonPropertyName属性を持つ適切なC#クラスを作成し、開発時間を数時間節約し、エラーを減らします。
💬ジェネレーターは異なるJSONデータ型をどのように処理しますか?
ジェネレーターはJSON型を適切なC#型にマッピングします:文字列はstringまたはDateTime(ISO-8601日付の場合)になり、整数はlongにマッピングされ、浮動小数点数はdoubleにマッピングされ、ブール値はboolにマッピングされ、オブジェクトは専用クラスになり、配列はList<T>になります。null値はプロパティをnull許容としてマークします(null許容参照が有効な場合は?サフィックス付き)。混合配列はList<object>を使用して異種データを保持します。
🔍JsonPropertyName属性とは何ですか?いつ使用すべきですか?
JsonPropertyName属性により、C#プロパティはPascalCase命名(C#規則)を使用でき、JSONは異なる命名(snake_caseやcamelCaseなど)を使用できます。属性は、シリアル化/逆シリアル化中に元のJSONキー名を保持します。JSONが非PascalCaseキーを使用しているが、コードで慣用的なC#プロパティ名を使用したい場合は、このオプションを有効にしてください。
💡null許容参照サポートとは何ですか?なぜ有効にするのですか?
null許容参照型(C# 8.0+)は、nullにできる場合に参照型に?を追加し、コンパイル時のnullチェックを有効にします。有効にすると、JSONサンプルにnull値が含まれている場合、ジェネレーターはプロパティに?を追加します。これにより、NullReferenceExceptionエラーを防ぎ、オプションフィールドを明示的にし、null安全性に関する最新のC#ベストプラクティスに従います。
📚生成後、生成されたクラスを変更できますか?
はい、ジェネレーターはデフォルトで部分クラスを作成する(または有効な場合)ため、生成されたコードを変更せずに別のファイルで拡張できます。カスタムメソッド、検証ロジック、ドメイン固有の属性を追加したり、インターフェースを実装したりできます。この分離により、生成されたコードがクリーンに保たれ、JSON構造が変更されたときにクラスを安全に再生成できます。

💡精度を上げるコツ

💡

代表的なサンプルを用意

任意項目や null を含む JSON を使うと、nullable 情報を正確に反映できます。
🧱

巨大レスポンスは分割

非常に大きな JSON はセクションごとに変換し、partial class で統合すると効率的です。
🧾

JSON を整形

コメントや末尾カンマを取り除き、パーサーエラーを防ぎましょう。

📝更新履歴

📌v1.0.251115
v1.0.251115

JsonPropertyName 切り替え、nullable 対応、統計パネル、.cs ダウンロードを備えた初期リリース

📦推奨コンポーネント

User Comments

0 / 2000
Loading...