C# JSON序列化与反序列化深度指南:从零开始掌握Json.NET与System.Text.Json实践与对比

avatar
作者
猴君
阅读量:1

一、Json.NET(Newtonsoft.Json)

1. 引入NuGet包

在项目中安装Json.NET库,可以通过NuGet Package Manager或命令行完成:

 

Bash

dotnet add package Newtonsoft.Json

2. 序列化

 

Csharp

using Newtonsoft.Json;  public class Person {     public string FirstName { get; set; }     public string LastName { get; set; } }  public class JsonNetSerializationDemo {     public static void SerializePerson(Person person)     {         // 序列化为JSON字符串         string json = JsonConvert.SerializeObject(person, Formatting.Indented);         Console.WriteLine(json);     } }  // 示例使用 JsonNetSerializationDemo.SerializePerson(new Person { FirstName = "John", LastName = "Doe" });

注释:使用JsonConvert.SerializeObject方法将Person对象序列化为格式化的JSON字符串。

3. 反序列化

 

Csharp

public static Person DeserializePerson(string json) {     // 反序列化为Person对象     Person person = JsonConvert.DeserializeObject<Person>(json);     return person; }  // 示例使用 string inputJson = "{\"FirstName\":\"Jane\",\"LastName\":\"Smith\"}"; Person deserializedPerson = JsonNetSerializationDemo.DeserializePerson(inputJson);

注释:使用JsonConvert.DeserializeObject方法将JSON字符串反序列化为Person对象。

二、System.Text.Json

1. 引入命名空间

无需额外安装NuGet包,直接引入System.Text.Json命名空间即可使用内置的JSON序列化/反序列化功能。

 

Csharp

using System.Text.Json;

2. 序列化

 

Csharp

public static void SerializePerson(Person person) {     // 创建JsonSerializerOptions实例(可选,用于设置序列化选项)     JsonSerializerOptions options = new JsonSerializerOptions     {         WriteIndented = true // 生成格式化的JSON     };      // 序列化为JSON字符串     string json = JsonSerializer.Serialize(person, options);     Console.WriteLine(json); }

注释:使用JsonSerializer.Serialize方法将Person对象序列化为格式化的JSON字符串,通过JsonSerializerOptions设置序列化选项。

3. 反序列化

 

Csharp

public static Person DeserializePerson(string json) {     // 反序列化为Person对象     Person person = JsonSerializer.Deserialize<Person>(json);     return person; }  // 示例使用 string inputJson = "{\"FirstName\":\"Jane\",\"LastName\":\"Smith\"}"; Person deserializedPerson = JsonNetSerializationDemo.DeserializePerson(inputJson);

注释:使用JsonSerializer.Deserialize方法将JSON字符串反序列化为Person对象。

三、特性与定制

  1. Json.NET

    • 使用[JsonProperty]属性控制序列化时的属性名称、顺序等。
    • 支持自定义序列化器与转换器。
  2. System.Text.Json

    • 使用[JsonPropertyName]属性控制序列化时的属性名称。
    • 使用JsonConverter<T>实现自定义转换器。
    • 支持JsonSerializerOptions中设置全局或类型的序列化行为。

四、性能对比

  • System.Text.Json通常比Json.NET更快,尤其是在大规模数据和高并发场景下,因为它更侧重于性能优化。
  • Json.NET功能更丰富,支持更多的自定义选项和复杂场景,但可能牺牲一定的性能。

五、总结

本文从零开始,详细介绍了C#中两种流行的JSON序列化与反序列化库——Json.NET和System.Text.Json的使用方法。通过创建对象、引入库或命名空间、编写序列化与反序列化代码,展示了如何使用这两种库将对象转换为JSON字符串,以及将JSON字符串还原为对象。每个示例均包含详尽的注释,解释了代码的工作原理和使用场景。通过这些内容,您应已全面理解如何在C#中使用Json.NET和System.Text.Json进行JSON序列化与反序列化,并了解了它们各自的特性和适用场景。结合文中提供的代码示例与注释,您可以根据项目需求选择合适的库进行JSON数据处理,并为进一步探索其高级功能打下坚实基础。

六、进阶话题

  • Json.NET高级特性:如条件忽略、循环引用处理、ISerializable支持等。
  • System.Text.Json高级特性:如非托管堆栈缓冲区、UTF8编码优化、流式读写等。
  • 序列化性能基准测试:对比不同库在特定场景下的性能差异。
  • 跨平台兼容性:探讨两种库在.NET Core、.NET Framework以及其他平台上的支持情况。

 

广告一刻

为您即时展示最新活动产品广告消息,让您随时掌握产品活动新动态!