JSON'dan C# Sınıfı

JSON'dan C#'a Dönüşüm Nedir?

JSON'dan C#'a dönüşüm, JSON verisinden güçlü türlendirilmiş C# sınıf tanımları üretme sürecidir. Bir .NET uygulaması bir API'den, yapılandırma dosyasından veya mesaj kuyruğundan JSON aldığında, bu veriyi nesnelere seri dışı bırakmak için C# sınıflarına ihtiyaç duyar. Özellikle JSON iç içe nesneler, diziler ve karma türler içerdiğinde bu sınıfları elle yazmak hem zahmetli hem de hata yapmaya açıktır.

Bir JSON'dan C# sınıfı üretici, JSON'unuzdaki yapıyı ve değerleri inceleyerek her alan için uygun C# türünü çıkarsar ve özellik erişimcileri ile serileştirme öznitelikleri içeren sınıf tanımları üretir. Çıktı .NET adlandırma kurallarını izler: PascalCase özellik adları, orijinal camelCase veya snake_case JSON anahtarlarıyla eşleştirme için JsonPropertyName öznitelikleri ve diziler için List'<'T'>' kullanımı.

Bu dönüşüm özellikle ASP.NET Core web API'lerinde, Azure Functions'da ve harici JSON verisi tüketen her .NET servisinde yaygındır. dynamic veya Dictionary'<'string, object'>' kullanmak yerine, türlendirilmiş sınıflar derleme zamanı güvenliği, IntelliSense desteği ve yalnızca çalışma zamanında ortaya çıkacak alan adı yazım hatalarına karşı koruma sağlar. JSON'unuzu bu araca yapıştırın ve kullanıma hazır C# sınıflarını anında alın.

Neden JSON'dan C# Üretici Kullanmalısınız?

JSON örneklerinden C# model sınıflarını elle yazmak zaman alır ve insan hatasına zemin hazırlar. Bir üretici tekrarlayan kısımları üstlenir; siz iş mantığına odaklanırsınız.

JSON'dan C#'a Kullanım Senaryoları

JSON'dan C#'a Tür Eşleme Başvurusu

Her JSON değer türü belirli bir C# türüne eşlenir. Üretici, en kesin türü seçmek için gerçek değerleri analiz eder. Örneğin ondalık noktası olmayan bir JSON sayısı int olurken 3,14 double olur. Null değerler object? (null olabilir başvuru türü) üretir; çünkü gerçek tür yalnızca null'dan çıkarsanamaz.

System.Text.Json ve Newtonsoft.Json

.NET'in iki önemli JSON serileştirme kütüphanesi vardır. Bu araçtan üretilen sınıflar, .NET Core 3.0'dan bu yana yerleşik seçenek olan System.Text.Json özniteliklerini (JsonPropertyName) kullanır. Projeniz Newtonsoft.Json kullanıyorsa öznitelikleri değiştirebilirsiniz.

Kod Örnekleri

Bu örnekler, JSON'dan üretilen C# sınıflarının her iki önemli serileştirme kütüphanesiyle nasıl tanımlanıp kullanılacağını ve komut satırından üretimin nasıl otomatikleştirileceğini göstermektedir.

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))

Sıkça Sorulan Sorular