JSONEntity C#

### C# 中 JSON 实体的概念与实现

在 C# 开发环境中，处理 JSON 数据是一个常见的任务。为了有效地解析和序列化 JSON 对象到 .NET 类型对象，通常会使用 `Newtonsoft.Json` 或者内置的 `System.Text.Json` 库。

#### 使用 Newtonsoft.Json 处理 JSON 实体

通过安装 NuGet 包 `Newtonsoft.Json` 可以方便地操作 JSON 数据：

using Newtonsoft.Json;
using System;

public class Person {
    public string Name { get; set; }
    public int Age { get; set; }

    public override string ToString() => $"{Name} is {Age} years old.";
}

class Program {
    static void Main(string[] args) {
        var person = new Person { Name = "Alice", Age = 30 };
        
        // 将对象转换成 JSON 字符串
        string jsonString = JsonConvert.SerializeObject(person);
        Console.WriteLine($"Serialized object to JSON: {jsonString}");

        // 解析 JSON 字符串并映射至实体类
        Person deserializedPerson = JsonConvert.DeserializeObject<Person>(jsonString);
        Console.WriteLine(deserializedPerson.ToString());
    }
}

这段代码展示了如何定义一个简单的 `Person` 类，并利用 `JsonConvert` 方法来完成对象与 JSON 字符串之间的相互转化[^1]。

#### 使用 System.Text.Json 进行 JSON 操作

自 .NET Core 3.0 起引入了新的命名空间 `System.Text.Json` 来支持原生 JSON 支持。此库提供了更高效的性能以及更好的安全性特性。

using System;
using System.Text.Json;
using System.Text.Json.Serialization;

public record Product(
    [property: JsonPropertyName("id")] Guid Id,
    [property: JsonPropertyName("name")] string Name);

class Example {
    private static async Task RunAsync() {
        var product = new Product(Guid.NewGuid(), "Example Product");

        // Serialize the object into a JSON string.
        string json = JsonSerializer.Serialize(product);
        Console.WriteLine(json); 

        // Deserialize from JSON back into an object.
        using (var doc = JsonDocument.Parse(json)) {
            foreach (JsonProperty prop in doc.RootElement.EnumerateObject()) {
                Console.WriteLine($"{prop.Name}: {prop.Value}");
            }
        }
    }
}

这里展示了一个更加现代的方式去创建不可变记录类型作为数据载体，并且采用异步方式读取 JSON 文档节点[^2]。