C# 如何处理 JSON 数据_C# JSON 数据处理完整教程-C#.Net教程-PHP中文网

C# 如何处理 JSON 数据_C# JSON 数据处理完整教程

小老鼠

发布： 2025-11-20 13:01:07

原创

467人浏览过

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

c# 如何处理 json 数据_c# json 数据处理完整教程

在 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;
<p>public class Person
{
public string Name { get; set; }
public int Age { get; set; }
}</p><p>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<Person>(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;
<p>string json = JsonConvert.SerializeObject(person);
Person person = JsonConvert.DeserializeObject<Person>(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; }
<pre class="brush:php;toolbar:false;"><pre class="brush:php;toolbar:false;">[JsonIgnore]
public int Age { get; set; }

登录后复制

}

处理复杂 JSON 结构

实际开发中，JSON 往往嵌套复杂，可能包含数组、字典或未知结构。

Intermediate Perl 电子书 chm版

从一个Perl爱好者到一个Perl程序员。《Intermediate Perl》将教您如何把Perl作为编程语言来使用，而不仅只是作为一种脚本语言。　　Perl是一种灵活多变、功能强大的编程语言，可以应用在从系统管理到网络编程再到数据库操作等很多方面。人们常说Perl让容易的事情变简单、让困难的事情变得可行。《Intermediate Perl》正是关于如何将技能从处理简单任务跃升到胜任困难任务的书籍。　　本书提供对Perl中级编程优雅而仔细的介绍。由畅销的《学习Perl》作者所著，本书提供了《学习P

查看详情

1. 解析 JSON 数组

string jsonArray = "[{""Name"":""A""},{""Name"":""B""}]";
List<Person> people = JsonSerializer.Deserialize<List<Person>>(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<Dictionary<string, object>>(json);
foreach (var kvp in data)
{
    Console.WriteLine($"{kvp.Key}: {kvp.Value}");
}

登录后复制