C#中处理JSON常用System.Text.Json和Newtonsoft.Json。首先引入对应命名空间,定义类结构,使用JsonSerializer.Serialize或JsonConvert.SerializeObject将对象转为JSON字符串;反序列化时用JsonSerializer.Deserialize或JsonConvert.DeserializeObject还原对象;可通过JsonSerializerOptions设置格式化、忽略null、不区分大小写等;Newtonsoft.Json支持特性映射、动态类型和复杂结构,适合高灵活性场景;解析数组、字典或未知结构可选用List、Dictionary或JsonDocument;处理大文件推荐Utf8JsonReader流式读取以节省内存;根据项目框架选择合适库并保持一致性。

在 C# 中处理 JSON 数据是现代开发中非常常见的需求,尤其是在与 Web API 交互、配置读写或前后端数据传输时。C# 提供了多种方式来序列化和反序列化 JSON 数据,最常用的是 System.Text.Json(.NET Core 3.0+ 默认)和第三方库 Newtonsoft.Json(Json.NET)。本文将带你全面掌握 C# 中处理 JSON 的核心方法。
使用 System.Text.Json 进行 JSON 操作
System.Text.Json 是微软官方推荐的高性能 JSON 处理库,内置于 .NET Core 3.0 及以上版本,无需额外安装包。
1. 序列化对象为 JSON 字符串
将 C# 对象转换为 JSON 字符串:
using System.Text.Json;public class Person { public string Name { get; set; } public int Age { get; set; } }
var person = new Person { Name = "张三", Age = 25 }; string jsonString = JsonSerializer.Serialize(person); // 输出: {"Name":"张三","Age":25}
2. 反序列化 JSON 字符串为对象
将 JSON 字符串还原为 C# 对象:
string json = @"{""Name"":""李四"",""Age"":30}";
Person person = JsonSerializer.Deserialize(json);
Console.WriteLine(person.Name); // 输出: 李四
3. 格式化输出 JSON
让生成的 JSON 更易读:
var options = new JsonSerializerOptions { WriteIndented = true };
string prettyJson = JsonSerializer.Serialize(person, options);
4. 忽略 null 值或大小写不敏感反序列化
通过选项控制行为:
var options = new JsonSerializerOptions
{
DefaultIgnoreCondition = JsonIgnoreCondition.WhenWritingNull,
PropertyNameCaseInsensitive = true
};
使用 Newtonsoft.Json(Json.NET)
Newtonsoft.Json 是功能更强大、灵活性更高的第三方库,支持更多特性,需通过 NuGet 安装:Install-Package Newtonsoft.Json
1. 序列化与反序列化
用法类似,但命名空间不同:
using Newtonsoft.Json;string json = JsonConvert.SerializeObject(person); Person person = JsonConvert.DeserializeObject
(json);
2. 支持匿名对象和动态类型
Newtonsoft 支持直接解析到 dynamic:
dynamic obj = JsonConvert.DeserializeObject(json); Console.WriteLine(obj.Name); // 输出属性值
3. 使用特性(Attribute)控制序列化行为
通过特性灵活定义字段映射:
public class Person
{
[JsonProperty("full_name")]
public string Name { get; set; }
[JsonIgnore]
public int Age { get; set; }
}
处理复杂 JSON 结构
实际开发中,JSON 往往嵌套复杂,可能包含数组、字典或未知结构。
NetShop网店系统
NetShop软件特点介绍: 1、使用ASP.Net(c#)2.0、多层结构开发 2、前台设计不采用任何.NET内置控件读取数据,完全标签化模板处理,加快读取速度3、安全的数据添加删除读取操作,利用存储过程模式彻底防制SQL注入式攻击4、前台架构DIV+CSS兼容IE6,IE7,FF等,有利于搜索引挚收录5、后台内置强大的功能,整合多家网店系统的功能,加以优化。6、支持三种类型的数据库:Acces
下载
1. 解析 JSON 数组
string jsonArray = "[{""Name"":""A""},{""Name"":""B""}]";
List people = JsonSerializer.Deserialize>(jsonArray);
2. 使用 JsonDocument(只读解析)
适合不需要映射到类的场景,如解析配置片段:
using JsonDocument doc = JsonDocument.Parse(jsonString);
JsonElement root = doc.RootElement;
string name = root.GetProperty("Name").GetString();
int age = root.GetProperty("Age").GetInt32();
3. 使用 Dictionary 解析未知结构
当字段不确定时:
var data = JsonSerializer.Deserialize>(json);
foreach (var kvp in data)
{
Console.WriteLine($"{kvp.Key}: {kvp.Value}");
}
常见问题与最佳实践
处理 JSON 时注意以下几点可避免常见错误:
- 确保类属性名与 JSON 字段匹配,或使用特性映射
- 日期格式默认可能不符合预期,可通过
JsonSerializerOptions设置转换器 - 处理大文件时建议使用
Utf8JsonReader流式读取,节省内存 - Newtonsoft.Json 支持更多类型(如 DataSet),但性能略低于 System.Text.Json
- 若项目已用 Newtonsoft,不建议强行切换,保持一致性更重要
基本上就这些。根据项目框架选择合适的 JSON 处理方式,掌握序列化、反序列化、格式控制和异常处理,就能高效应对大多数场景。









