実用ガイド

JSON→C# クラス生成ツール — 使い方ガイドと技術原理

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

ツールを開く

概要

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

主な概念

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 を未然に防げます。

主な機能

強固な型付け

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

JsonPropertyName 対応

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

nullable 対応

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

生成統計

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

よくある質問

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構造が変更されたときにクラスを安全に再生成できます。

関連ドキュメント

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

ツールを開いて機能をお試しください。

ツールを開く