0

0

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

小老鼠

小老鼠

发布时间:2025-11-20 13:01:07

|

492人浏览过

|

来源于php中文网

原创

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 数据_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;

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网店系统

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 处理方式,掌握序列化、反序列化、格式控制和异常处理,就能高效应对大多数场景。

相关专题

更多
json数据格式
json数据格式

JSON是一种轻量级的数据交换格式。本专题为大家带来json数据格式相关文章,帮助大家解决问题。

409

2023.08.07

json是什么
json是什么

JSON是一种轻量级的数据交换格式,具有简洁、易读、跨平台和语言的特点,JSON数据是通过键值对的方式进行组织,其中键是字符串,值可以是字符串、数值、布尔值、数组、对象或者null,在Web开发、数据交换和配置文件等方面得到广泛应用。本专题为大家提供json相关的文章、下载、课程内容,供大家免费下载体验。

532

2023.08.23

jquery怎么操作json
jquery怎么操作json

操作的方法有:1、“$.parseJSON(jsonString)”2、“$.getJSON(url, data, success)”;3、“$.each(obj, callback)”;4、“$.ajax()”。更多jquery怎么操作json的详细内容,可以访问本专题下面的文章。

309

2023.10.13

go语言处理json数据方法
go语言处理json数据方法

本专题整合了go语言中处理json数据方法,阅读专题下面的文章了解更多详细内容。

74

2025.09.10

string转int
string转int

在编程中,我们经常会遇到需要将字符串(str)转换为整数(int)的情况。这可能是因为我们需要对字符串进行数值计算,或者需要将用户输入的字符串转换为整数进行处理。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

315

2023.08.02

c语言中null和NULL的区别
c语言中null和NULL的区别

c语言中null和NULL的区别是:null是C语言中的一个宏定义,通常用来表示一个空指针,可以用于初始化指针变量,或者在条件语句中判断指针是否为空;NULL是C语言中的一个预定义常量,通常用来表示一个空值,用于表示一个空的指针、空的指针数组或者空的结构体指针。

231

2023.09.22

java中null的用法
java中null的用法

在Java中,null表示一个引用类型的变量不指向任何对象。可以将null赋值给任何引用类型的变量,包括类、接口、数组、字符串等。想了解更多null的相关内容,可以阅读本专题下面的文章。

435

2024.03.01

js 字符串转数组
js 字符串转数组

js字符串转数组的方法:1、使用“split()”方法;2、使用“Array.from()”方法;3、使用for循环遍历;4、使用“Array.split()”方法。本专题为大家提供js字符串转数组的相关的文章、下载、课程内容,供大家免费下载体验。

254

2023.08.03

Java 项目构建与依赖管理(Maven / Gradle)
Java 项目构建与依赖管理(Maven / Gradle)

本专题系统讲解 Java 项目构建与依赖管理的完整体系,重点覆盖 Maven 与 Gradle 的核心概念、项目生命周期、依赖冲突解决、多模块项目管理、构建加速与版本发布规范。通过真实项目结构示例,帮助学习者掌握 从零搭建、维护到发布 Java 工程的标准化流程,提升在实际团队开发中的工程能力与协作效率。

10

2026.01.12

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
MongoDB 教程
MongoDB 教程

共17课时 | 2万人学习

Swoft2.x速学之http api篇课程
Swoft2.x速学之http api篇课程

共16课时 | 0.9万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号