JSON から C#

関連おすすめ

JSONからC#について：JSONデータをコンパイル可能なC# POCOクラスに変換する

ユースケース

• ASP.NET Core Web API：OpenAPI/SwaggerドキュメントのサンプルJSONをDTOクラスに変換、[FromBody]モデルバインディングと組み合わせてフロントエンドリクエストを受信
• ASP.NET Core MVC：フォーム/JSONリクエストボディを強く型付けされたModelに変換、ModelState自動検証と組み合わせて使用
• Newtonsoft.Jsonデシリアライズ：サードパーティインターフェースレスポンスJSONを[JsonProperty]付きPOCOクラスに変換、手動でのフィールドマッピングが不要
• System.Text.Json高性能シナリオ：JSONをrecord型またはinit-onlyプロパティに変換、JsonSerializer.Deserialize<T>と組み合わせて起動を高速化
• Unityゲームスクリプト：ネットワークAPIから返されるJSON（プレイヤーデータ、レベル設定、ショップアイテム、ランキング）をシリアライズ可能なScriptableObjectデータモデルに変換
• .NET MAUIクロスプラットフォームアプリ：バックエンドAPI JSONをModelクラスに変換、XAMLデータバインディングで使用、iOS/Android/Windows間でビジネスモデルを共有
• Blazor Server / WebAssembly：API JSONを強く型付けされたコンポーネントパラメータ/サーバーモデルに変換、@inject HttpClientと組み合わせてフロントエンド/バックエンド共有型を消費
• Entity Framework Core：データベースからエクスポートしたJSONドキュメントをエンティティクラスに変換、EF Coreモデルマイグレーションの参照基底クラスとして使用、[Key]/[Required]などのデータアノテーションと組み合わせ
• Azure Functions / AWS Lambda：Event Grid/SNS/API Gateway/Cosmos DBトリガーイベントのJSONを強く型付けされたイベントパラメータに変換、サーバーレス関数シグネチャを簡素化
• SignalRリアルタイム通信：サーバーからプッシュされるJSONメッセージ（チャット、通知、相場、IoTデータ）をC#型に変換、Hubメソッドで強く型付けして消費
• マイクロサービスインターフェース契約：サービス間RPC（gRPC-Web/HTTP/WCF）のJSONリクエスト/レスポンスサンプルをC#クラスに変換、複数チームで共有する契約定義として使用
• 設定ファイル読み込み：appsettings.jsonのサブ構造をOptionsパターンクラスに変換（例: MyOptions : IOptions<MyOptions>をIConfiguration.Bindと組み合わせて使用）
• テストデータ準備：JSONフィクスチャをC#クラスに変換後、Newtonsoft/System.Text.Jsonでデシリアライズしてユニットテストドリブン、xUnit/NUnit/MSTestと組み合わせて使用
• クローラーデータ解析：HtmlAgilityPack/AngleSharp/PuppeteerSharpで取得したJSONデータをC#クラスに変換、JObject動的アクセスによるフィールド漏れを回避
• APIドキュメント作成：Swagger/OpenAPIドキュメント、ReDoc、Knife4j、Swagger UIにC#クラスサンプルをschema定義として埋め込み、ドキュメントの可読性を向上
• コードレビューコラボレーション：APIレスポンスJSONを直接読みやすいPOCOに変換、Code Review時にフィールド命名、型選択、アノテーション使用について議論しやすく
• 古いプロジェクトリファクタリング：JObject/Dictionary<string, object>ベースの動的アクセスをPOCOベースの強く型付けされたアクセスにリファクタリング、コンパイル時型チェックと保守性を向上
• 教育とトレーニング：C#コース、.NET入門教育でサンプルJSONをPOCOに変換し、オブジェクト指向モデリング、プロパティアクセサ、シリアライゼーションの原理をデモンストレーション

使い方

1. 左側のエディタにJSONコンテンツを貼り付けるか、アップロードボタンをクリックして.json/.txtファイルを選択するか、サンプルボタンをクリックして内蔵データを読み込みます
2. 400ms待つと自動的に変換され、右側に生成されたC# POCOクラスコードが表示されます
3. JSONフォーマットエラーがある場合は、「JSON修正」ボタンをクリックして一般的な構文問題を自動修正してから再変換します
4. 「コピー」ボタンをクリックして単一クラスをクリップボードにコピーし、Visual Studio/Rider/VS Codeに貼り付けるか、「ダウンロード」をクリックして.csファイルとして保存します

特徴

• 純ブラウザローカル生成：JSON解析とC#コード生成はすべてJavaScript + quicktype-coreでブラウザ内で完了、入力データはいかなるサーバーにもアップロードされません
• POCO + record両対応：デフォルトでシリアライズ可能なPOCOクラスを生成、ワンクリックでC# 9+のrecord型に切り替え可能、モダン.NETコーディングスタイルにマッチ
• Newtonsoft [JsonProperty]アノテーション：各フィールドに自動的に[JsonProperty("元のkey")]を生成、Newtonsoft.Jsonのデフォルト動作と互換、PascalCaseフィールド名でもデシリアライズに影響なし
• ネストされたオブジェクトの自動分割：JSONのネストされたオブジェクトは再帰的に独立したC#クラスとして生成、フィールド名の先頭大文字で命名（例: address → Address）、型の重複を回避
• Listジェネリックの自動展開：JSON配列は自動的にList<T>に変換、Tは配列の最初の要素から自動推論（["a","b"] → List<string>、[{...}] → List<Item>）
• Nullable<T>の自動推論：JSON null値フィールドは自動的にNullable<T>としてマーク（例: long? / string? / bool?）、コンパイル時にnull参照例外を回避
• PascalCaseフィールド命名：snake_case入力は自動的にPascalCaseに変換（例: user_name → UserName）、同時に[JsonProperty]アノテーションは元のkeyを保持してデシリアライズ互換性を維持
• 多様な値型マッピング：string → string、integer → long、float → double、bool → bool、array → List<T>、null → Nullable<T>
• 完全な.csテンプレート：using System.Collections.Generic; + namespace + public class + フィールド + プロパティを含む標準C#ファイルを生成、直接コンパイル可能
• コピーとダウンロード：ワンクリックで単一クラスをクリップボードにコピー、または.csファイルとしてダウンロードしてVisual Studio / Rider / VS Codeに直接ドラッグ＆ドロップ
• JSONエラーのワンクリック修正：末尾のカンマ、単一引用符、引用符の欠落などの一般的なフォーマットエラーを自動修正、修正成功後にC#コード生成を続行
• ローカル履歴：localStorageに基づいて最近の入力を自動保存、ページをリフレッシュまたは誤って閉じた後もすばやく復元して編集を続行可能

コード例

using Newtonsoft.Json;
using System;
using System.Net.Http;
using System.Threading.Tasks;

public class ApiClient
{
    private static readonly HttpClient _http = new HttpClient();

    // 本ツールが生成したPOCO：
    public class User
    {
        [JsonProperty("id")]
        public long Id { get; set; }

        [JsonProperty("name")]
        public string Name { get; set; }

        [JsonProperty("email")]
        public string Email { get; set; }

        [JsonProperty("is_active")]
        public bool? IsActive { get; set; }
    }

    public static async Task<User> GetUserAsync(int userId)
    {
        // 1) APIを呼び出してJSON文字列を取得
        var json = await _http.GetStringAsync($"https://api.example.com/users/{userId}");

        // 2) 本ツールが生成したPOCOにデシリアライズ
        //    内部で[JsonProperty("id")]などのアノテーションに従ってsnake_case JSONを自動マッピング
        var user = JsonConvert.DeserializeObject<User>(json);

        Console.WriteLine($"User: {user.Name} ({user.Email})");
        return user;
    }
}

using Microsoft.AspNetCore.Mvc;
using System.Collections.Generic;
using System.Linq;

// 本ツールが生成したPOCO（デフォルトでNewtonsoft [JsonProperty]を使用）：
public class CreateOrderRequest
{
    [Newtonsoft.Json.JsonProperty("user_id")]
    public long UserId { get; set; }

    [Newtonsoft.Json.JsonProperty("items")]
    public List<OrderItem> Items { get; set; }
}

public class OrderItem
{
    [Newtonsoft.Json.JsonProperty("product_id")]
    public long ProductId { get; set; }

    [Newtonsoft.Json.JsonProperty("quantity")]
    public long Quantity { get; set; }
}

[ApiController]
[Route("api/[controller]")]
public class OrdersController : ControllerBase
{
    [HttpPost]
    public IActionResult Create([FromBody] CreateOrderRequest request)
    {
        if (request == null || request.Items == null || !request.Items.Any())
        {
            return BadRequest("Items cannot be empty");
        }

        // ビジネスロジック：注文を保存
        // var order = OrderService.Create(request);

        return Ok(new { order_id = 12345, status = "created" });
    }
}

/*
 * 対応する.csproj依存関係：
 * <PackageReference Include="Microsoft.AspNetCore.Mvc.NewtonsoftJson" Version="7.0.0" />
 * <PackageReference Include="Newtonsoft.Json" Version="13.0.3" />
 */

using System.Net.Http.Json;
using System.Text.Json.Serialization;
using System.Threading.Tasks;

// 本ツールはデフォルトでPOCO classを生成；以下のように手動でrecord型（イミュータブルデータキャリア）に変更：
public record User
{
    [JsonPropertyName("id")]
    public long Id { get; init; }

    [JsonPropertyName("name")]
    public string Name { get; init; }

    [JsonPropertyName("email")]
    public string Email { get; init; }

    [JsonPropertyName("is_active")]
    public bool? IsActive { get; init; }
}

public class ApiClient
{
    private static readonly HttpClient _http = new HttpClient();

    public static async Task<User> GetUserAsync(int userId)
    {
        // System.Text.Json：GetFromJsonAsyncがHTTP + デシリアライズを1行で完了
        var user = await _http.GetFromJsonAsync<User>(
            $"https://api.example.com/users/{userId}");

        System.Console.WriteLine($"User: {user.Name} ({user.Email})");
        return user;
    }
}

/*
 * 対応する.csproj依存関係（System.Text.Jsonは組み込み、追加インストール不要）：
 * <TargetFramework>net7.0</TargetFramework>
 *
 * プロジェクトが.NET 7+で[JsonProperty]のNewtonsoft記法と互換性を持たせたい場合は、
 * Program.csに以下を追加できます：
 *   builder.Services.AddControllers()
 *       .AddNewtonsoftJson(options =>
 *       {
 *           options.SerializerSettings.ContractResolver =
 *               new Newtonsoft.Json.Serialization.DefaultContractResolver();
 *       });
 */

Best Practices

よくある質問

トラブルシューティング

用語集

POCO (Plain Old CLR Object)

C#/.NETにおける「普通のCLRオブジェクト」の略称で、制約は：パブリックデフォルトコンストラクタ + プライベートフィールド + パブリック{ get; set; }プロパティ + フレームワーク非依存。本ツールが生成するのは標準POCOです。

record

C# 9+で導入されたイミュータブルデータキャリア型で、参照等価性ではなく値等価性を使用します。本ツールで生成後に手動でrecordに変更でき、DTO、APIレスポンスモデル、イミュータブル設定などのシナリオに適しています。

[JsonProperty]

Newtonsoft.Jsonのフィールドマッピング属性。本ツールはデフォルトで各フィールドに[JsonProperty("元のkey")]を追加し、PascalCaseフィールド名がsnake_case JSONを正しくデシリアライズできるようにします。

Newtonsoft.Json

Json.NETとも呼ばれ、.NETエコシステムで最も人気のあるJSONライブラリ。エコシステムが最も豊富で互換性が最も高く、ほぼすべての.NETプロジェクトでサポートされています。ASP.NET Core 3.0以前はデフォルトで使用され、3.0以降はSystem.Text.Jsonに変更されましたが、NuGetパッケージを介して引き続き互換性があります。

System.Text.Json

.NET Core 3.0+に組み込まれた高性能JSONライブラリ。起動が速く、メモリ使用量が少なく、AOTフレンドリーです。機能には[JsonPropertyName]（Newtonsoftの[JsonProperty]に対応）とJsonNamingPolicyカスタム命名ポリシーが含まれます。

Nullable<T>

C#で値型がnull許容であることを表す形式（例: long? / bool?）。本ツールはJSON nullフィールドを自動的にNullable<T>と推論し、コンパイル時にnull参照例外を回避します。

List<T>

.NETコレクションフレームワークのジェネリックリスト型。本ツールはJSON配列を自動的にList<T>に変換し、Tは配列の最初の要素から自動推論されます（例: ["a"] → List<string>）。

namespace

C#でクラスを整理するための名前空間キーワードで、Javaのpackageに似ています。本ツールが生成するコードはデフォルトでnamespaceがなく、手動で追加できます（例: namespace MyApp.Models）。

ASP.NET Core

マイクロソフトのオープンソースクロスプラットフォームWebフレームワーク。本ツールで生成されるPOCOクラスは、ASP.NET CoreのController [FromBody]モデルバインディング、Minimal API、Blazorコンポーネントパラメータなどのシナリオで直接使用できます。

Unity

世界で最も人気のあるゲームエンジンで、スクリプト言語としてC#を使用しています。本ツールで生成されるPOCOクラスは、UnityネットワークAPIレスポンス解析、ScriptableObject設定データモデリングに使用できます。

Snake_case → PascalCase

フィールド命名規則の変換。snake_case命名（例: user_name、created_at）をPascalCase命名（例: UserName、CreatedAt）に変換し、.NET公式命名規則に準拠します。

quicktype-core

本ツールが基盤として依存するオープンソース多言語JSON型生成ライブラリ（quicktypeプロジェクト）。C#、Java、TypeScript、Rust、Go、Swiftなど10以上の言語をサポートし、TypeScript + WebAssemblyに基づいてブラウザで実行されます。

.NET MAUI

マイクロソフトのクロスプラットフォームUIフレームワーク（.NET Multi-platform App UI）。C#コードはiOS/Android/Windows/macOSで共有できます。本ツールで生成されるPOCOは、MAUI XAMLデータバインディングのModelとして適しています。

Blazor

マイクロソフトのWebAssemblyベースのSPAフレームワークで、ServerとWebAssemblyの2つのモードがあります。本ツールで生成されるC#クラスは、Blazorコンポーネントパラメータ、強く型付けされたAPIレスポンスモデルに使用でき、単一言語フルスタック開発効率を向上させます。

HttpClient.GetFromJsonAsync

.NET 5+/System.Net.Http.Json拡張メソッド。HTTP GET + JSONデシリアライズを1行で完了します。本ツールで生成されるPOCOと組み合わせることで、HTTP APIクライアントコードを大幅に簡素化できます。

JsonNamingPolicy

System.Text.JsonでJSONフィールド名とC#プロパティ名のマッピングポリシーを制御するためのクラス（例: CamelCase、SnakeCaseLower）。Newtonsoft.Jsonは[JsonProperty]アノテーションまたはContractResolverで実現します。

IOptions<T>

.NET Optionsパターンのコアインターフェース。appsettings.jsonのサブ構造を強く型付けされたクラスにバインドします。本ツールで生成されるPOCOはIConfiguration.Bindと組み合わせてIOptions<T>の実装として直接使用できます。

JSON型からC#型へのマッピング早見表

ツールはJSON値の型に基づいて対応するC#/.NET型を自動的に推論します：

Newtonsoft.JsonとSystem.Text.Jsonアノテーション対比表

.NETエコシステムの2大主流JSONライブラリのフィールドマッピング属性対比。本ツールはデフォルトでNewtonsoft互換の[JsonProperty]を生成します：

Privacy & Security

本JSONからC#ツールのすべての操作は完全にあなたのブラウザローカルで完了します：JSON解析、C#コード生成、ファイルダウンロードはすべてブラウザのJavaScript + WebAssembly（quicktype-core）を介してクライアント側で実行され、ネットワークを介していかなるサーバーにもJSONコンテンツ、アップロードされたファイル、または生成されたコードを送信しません。ファイルアップロードはブラウザのネイティブFileReader APIを使用して直接メモリに読み込み、いかなる中間サービスも経由しません。Cookieトラッキングは使用せず、ユーザー入力データや使用状況データを一切収集しません。ページを閉じるかリフレッシュすると、すべての入力と出力コンテンツは自動的にメモリから消去されます。APIキー、トークン、機密ビジネスデータを含むJSONの処理に適しています。

Authoritative References

• MicrosoftMicrosoft Learn - C#プログラミングガイド
• MicrosoftMicrosoft Learn - System.Text.Jsonの概要
• NewtonsoftNewtonsoft.Json公式ドキュメント
• MicrosoftMicrosoft Learn - ASP.NET Core Web APIモデルバインディング
• MicrosoftMicrosoft Learn - C# 9 record型