JSON เป็น C# Class

การแปลง JSON เป็น C# คืออะไร?

การแปลง JSON เป็น C# คือกระบวนการสร้างนิยาม C# class ที่มีการกำหนดประเภทอย่างชัดเจนจากข้อมูล JSON เมื่อแอปพลิเคชัน .NET ได้รับ JSON จาก API, ไฟล์กำหนดค่า หรือ message queue จำเป็นต้องมี C# classes เพื่อ deserialize ข้อมูลนั้นเป็น objects การเขียน classes เหล่านี้ด้วยมือเป็นงานที่น่าเบื่อและเกิดข้อผิดพลาดได้ง่าย โดยเฉพาะเมื่อ JSON มี nested objects, arrays และประเภทผสม

เครื่องมือสร้าง C# class จาก JSON จะตรวจสอบโครงสร้างและค่าใน JSON ของคุณ อนุมานประเภท C# ที่เหมาะสมสำหรับแต่ละ field และสร้างนิยาม class พร้อม property accessors และ serialization attributes ผลลัพธ์เป็นไปตามแบบแผนการตั้งชื่อของ .NET ได้แก่ ชื่อ property แบบ PascalCase, JsonPropertyName attributes สำหรับแมปกับ JSON keys เดิมที่เป็น camelCase หรือ snake_case และการใช้ List'<'T'>' สำหรับ arrays อย่างถูกต้อง

การแปลงนี้พบบ่อยโดยเฉพาะใน ASP.NET Core web APIs, Azure Functions และบริการ .NET ใดก็ตามที่ใช้ข้อมูล JSON จากภายนอก แทนที่จะใช้ dynamic หรือ Dictionary'<'string, object'>' การใช้ typed classes ให้ความปลอดภัยในระหว่าง compile, รองรับ IntelliSense และป้องกันข้อผิดพลาดจากการพิมพ์ชื่อ field ผิดซึ่งจะไม่พบจนกว่าจะถึง runtime วาง JSON ลงในเครื่องมือนี้และรับ C# classes ที่พร้อมใช้งานทันที

ทำไมต้องใช้เครื่องมือสร้าง C# จาก JSON?

การเขียน C# model classes จาก JSON ด้วยมือใช้เวลามากและเกิดข้อผิดพลาดของมนุษย์ได้ เครื่องมือสร้างอัตโนมัติจัดการส่วนที่ซ้ำซากเพื่อให้คุณโฟกัสกับ business logic ได้

กรณีใช้งาน JSON เป็น C#

ตารางอ้างอิงการแมปประเภท JSON เป็น C#

ค่า JSON แต่ละประเภทแมปกับประเภท C# เฉพาะเจาะจง เครื่องมือสร้างจะวิเคราะห์ค่าจริงเพื่อเลือกประเภทที่แม่นยำที่สุด ตัวอย่างเช่น ตัวเลข JSON ที่ไม่มีจุดทศนิยมจะกลายเป็น int ขณะที่ 3.14 จะกลายเป็น double ค่า null จะสร้าง object? (nullable reference type) เนื่องจากไม่สามารถอนุมานประเภทจริงจาก null เพียงอย่างเดียวได้

System.Text.Json กับ Newtonsoft.Json

.NET มี JSON serialization libraries หลักสองตัว Classes ที่สร้างจากเครื่องมือนี้ใช้ System.Text.Json attributes (JsonPropertyName) ซึ่งเป็นตัวเลือกที่ built-in ตั้งแต่ .NET Core 3.0 หากโปรเจกต์ของคุณใช้ Newtonsoft.Json คุณสามารถเปลี่ยน attributes ได้

ตัวอย่างโค้ด

ตัวอย่างเหล่านี้แสดงวิธีนิยามและใช้ C# classes ที่สร้างจาก JSON โดยใช้ทั้ง serialization libraries หลัก รวมถึงวิธีการสร้างอัตโนมัติจาก command line

using System.Text.Json;

var json = """{"id": 1, "name": "Alice", "active": true}""";
var user = JsonSerializer.Deserialize<User>(json);
Console.WriteLine(user.Name); // → "Alice"

public class User
{
    [JsonPropertyName("id")]
    public int Id { get; set; }

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

    [JsonPropertyName("active")]
    public bool Active { get; set; }
}

using Newtonsoft.Json;

var json = @"{""id"": 1, ""name"": ""Alice"", ""scores"": [98, 85]}";
var user = JsonConvert.DeserializeObject<User>(json);
Console.WriteLine(user.Scores[0]); // → 98

public class User
{
    [JsonProperty("id")]
    public int Id { get; set; }

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

    [JsonProperty("scores")]
    public List<int> Scores { get; set; }
}

// Install: npm install -g quicktype
// Generate C# classes from JSON:
// quicktype --lang csharp --src data.json --out Models.cs

// From stdin:
// echo '{"id": 1, "name": "Alice"}' | quicktype --lang csharp

// Output:
// public class Root
// {
//     [JsonPropertyName("id")]
//     public int Id { get; set; }
//
//     [JsonPropertyName("name")]
//     public string Name { get; set; }
// }

import json

def json_to_csharp(data: dict, class_name: str = "Root") -> str:
    lines = [f"public class {class_name}", "{"]
    type_map = {str: "string", int: "int", float: "double", bool: "bool"}

    for key, value in data.items():
        cs_type = type_map.get(type(value), "object")
        prop = key[0].upper() + key[1:]  # PascalCase
        lines.append(f'    [JsonPropertyName("{key}")]')
        lines.append(f'    public {cs_type} {prop} {{ get; set; }}')
        lines.append('')
    lines.append("}")
    return "\n".join(lines)

data = json.loads('{"id": 1, "name": "Alice", "active": true}')
print(json_to_csharp(data))

คำถามที่พบบ่อย