全面掌握C#的JObject类：C#开发之JSON数据解析与操作实战指南

ops/2025/2/7 5:08:49/

        在C#中，处理JSON数据是日常开发中常见的任务之一。JObject类是 Newtonsoft.Json（也称为Json.NET）库的一部分，它提供了一个灵活且强大的方式来解析、查询和操作JSON数据。本文将深入探讨JObject类的各种用法，包括基本操作、进阶技巧和最佳实践。

目录

1. Newtonsoft.Json简介

2. 安装Json.NET

3. JObject基础用法

解析JSON字符串

从文件加载JSON数据

创建JObject

4. 访问和操作JSON数据

访问属性

获取嵌套属性

使用方法获取值

处理数组

5. 修改JSON数据

添加新属性

更新现有属性

删除属性

6. 遍历JObject

7. LINQ to JSON

示例：筛选特定条件的数据

使用SelectTokens

8. 序列化和反序列化

将JObject序列化为JSON字符串

从C#对象反序列化为JObject

反序列化到C#类

9. 错误处理与验证

解析无效JSON

类型转换错误

用TryGetValue

10. 性能考虑

11. 最佳实践

12. 完整示例

13. 总结

1. Newtonsoft.Json简介

Json.NET 是一个流行的、高性能的 JSON 框架，用于 .NET。它提供了广泛的功能来处理 JSON 数据，包括序列化、反序列化、LINQ 查询等。JObject类是其核心组件之一，用于表示JSON对象。

2. 安装Json.NET

在使用JObject之前，确保已安装Json.NET库。你可以通过引用Newtonsoft.Json.dll或用NuGet来安装：

Install-Package Newtonsoft.Json

或者使用.NET CLI：

dotnet add package Newtonsoft.Json

3. JObject基础用法

解析JSON字符串

使用JObject.Parse方法可以将JSON字符串解析为JObject实例。

using Newtonsoft.Json.Linq;string json = @"{ 'name': 'John', 'age': 30 }";
JObject jsonObject = JObject.Parse(json);Console.WriteLine(jsonObject["name"]);  // 输出: John
Console.WriteLine(jsonObject["age"]);   // 输出: 30

从文件加载JSON数据

如果JSON数据存储在文件中，可以读取文件内容并解析：

using Newtonsoft.Json.Linq;
using System.IO;string json = File.ReadAllText("data.json");
JObject jsonObject = JObject.Parse(json);// 处理 jsonObject

创建JObject

除了解析JSON字符串，还可以手动创建JObject：

using Newtonsoft.Json.Linq;JObject jsonObject = new JObject
{{ "name", "Alice" },{ "age", 25 },{ "skills", new JArray("C#", "JavaScript", "SQL") }
};Console.WriteLine(jsonObject.ToString());

4. 访问和操作JSON数据

访问属性

可以使用索引器通过属性名称访问值：

string name = (string)jsonObject["name"];
int age = (int)jsonObject["age"];Console.WriteLine($"Name: {name}, Age: {age}");

获取嵌套属性

对于嵌套的JSON对象，可以通过连锁索引器访问：

string nestedJson = @"{'person': {'name': 'Alice','age': 25}
}";
JObject jsonObject = JObject.Parse(nestedJson);string personName = (string)jsonObject["person"]["name"];
int personAge = (int)jsonObject["person"]["age"];Console.WriteLine($"Person Name: {personName}, Age: {personAge}");

或者使用SelectToken方法，支持使用路径表达式：

string personName = (string)jsonObject.SelectToken("person.name");
int personAge = (int)jsonObject.SelectToken("person.age");

使用方法获取值

JObject提供了多种方法来获取值，如Value<T>、GetValue等：

string name = jsonObject.Value<string>("name");
int age = jsonObject.Value<int>("age");// 或者
string name = (string)jsonObject.GetValue("name");
int age = (int)jsonObject.GetValue("age");

处理数组

JSON中的数组对应JArray对象：

string jsonWithArray = @"{'name': 'John','skills': ['C#', 'JavaScript', 'SQL']
}";
JObject jsonObject = JObject.Parse(jsonWithArray);
JArray skills = (JArray)jsonObject["skills"];foreach (var skill in skills)
{Console.WriteLine(skill);
}

或者使用LINQ：

var skills = jsonObject["skills"].Select(skill => (string)skill);
foreach (var skill in skills)
{Console.WriteLine(skill);
}

5. 修改JSON数据

添加新属性

可以向JObject中添加新属性：

jsonObject["newProperty"] = "New Value";
// 或者
jsonObject.Add("newProperty", "New Value");

更新现有属性

直接赋值即可更新属性：

jsonObject["age"] = 31;

删除属性

使用Remove方法删除属性：

jsonObject.Remove("age");

6. 遍历JObject

你可以遍历JObject的属性，访问键值对：

foreach (var property in jsonObject.Properties())
{string propName = property.Name;JToken propValue = property.Value;Console.WriteLine($"{propName}: {propValue}");
}

或者通过键值对：

foreach (var pair in jsonObject)
{string key = pair.Key;JToken value = pair.Value;Console.WriteLine($"{key}: {value}");
}

7. LINQ to JSON

JObject支持使用LINQ查询JSON数据，提供了强大的数据筛选和操作能力。

示例：筛选特定条件的数据

假设有如下JSON数组：

string json = @"{'employees': [{ 'name': 'John', 'age': 30, 'department': 'HR' },{ 'name': 'Jane', 'age': 25, 'department': 'IT' },{ 'name': 'Bob', 'age': 35, 'department': 'IT' }]
}";
JObject jsonObject = JObject.Parse(json);// 查找所有在IT部门的员工
var itEmployees = jsonObject["employees"].Where(emp => (string)emp["department"] == "IT");foreach (var emp in itEmployees)
{Console.WriteLine(emp["name"]);  // 输出: Jane, Bob
}

使用SelectTokens

SelectTokens方法允许使用JSON路径查询，支持通配符等高级功能：

// 获取所有员工的名字
var names = jsonObject.SelectTokens("$.employees[*].name");foreach (var name in names)
{Console.WriteLine(name);
}

8. 序列化和反序列化

将JObject序列化为JSON字符串

string serializedJson = jsonObject.ToString();
Console.WriteLine(serializedJson);

可以指定格式化选项：

string indentedJson = jsonObject.ToString(Newtonsoft.Json.Formatting.Indented);
Console.WriteLine(indentedJson);

从C#对象反序列化为JObject

var person = new
{name = "Alice",age = 25,skills = new[] { "C#", "JavaScript" }
};JObject jsonObject = JObject.FromObject(person);
Console.WriteLine(jsonObject.ToString());

反序列化到C#类

虽然JObject提供了灵活性，但在某些情况下，将JSON数据强类型化为C#类更为合适。以下是一个示例：

public class Person
{public string Name { get; set; }public int Age { get; set; }
}// 反序列化
Person person = jsonObject.ToObject<Person>();
Console.WriteLine($"{person.Name}, {person.Age}");

9. 错误处理与验证

在解析JSON时，可能会遇到无效的JSON格式或类型不匹配的问题。以下是一些常见的错误处理方法：

解析无效JSON

使用TryParse方法（需要手动实现）或捕获异常：

try
{JObject jsonObject = JObject.Parse(invalidJson);
}
catch (JsonReaderException ex)
{Console.WriteLine($"JSON解析错误: {ex.Message}");
}

类型转换错误

当访问属性时，如果类型不匹配，会抛出异常或导致默认值：

// 安全获取字符串值
string name = jsonObject["name"]?.ToString();// 安全获取整数值，带默认值
int age = jsonObject["age"]?.Value<int>() ?? 0;

用TryGetValue

JObject提供了TryGetValue方法，可以安全地尝试获取属性值：

if (jsonObject.TryGetValue("name", out JToken nameToken))
{string name = (string)nameToken;Console.WriteLine(name);
}
else
{Console.WriteLine("属性 'name' 不存在");
}

10. 性能考虑

虽然JObject提供了高度的灵活性，但在处理大型JSON数据或在性能敏感的应用中，可能会遇到性能瓶颈。以下是一些优化建议：

  • 预先定义C#类：如果JSON结构固定，使用强类型的C#类进行序列化/反序列化通常更高效。

    Person person = JsonConvert.DeserializeObject<Person>(jsonString);

  • 避免不必要的解析：仅解析需要的部分，而不是整个JSON结构。例如，使用JsonTextReader进行逐行读取。

    using (var stringReader = new StringReader(json))
using (var jsonReader = new JsonTextReader(stringReader))
{while (jsonReader.Read()){// 处理需要的部分}
}

  • 缓存解析结果：如果需要多次访问相同的JSON数据，考虑缓存已解析的JObject实例。

11. 最佳实践

  • 使用强类型对象：当JSON结构已知且固定时，使用强类型的C#类有助于代码的可维护性和性能。

  • 处理可选属性：在访问JSON属性时，使用安全访问方式以处理缺失或可选的属性。

    string middleName = jsonObject["middleName"]?.ToString();

  • 利用LINQ：充分利用LINQ的强大功能，简化复杂的数据查询和操作。

  • 异常处理：在解析和操作JSON数据时，始终添加适当的异常处理逻辑，以防止应用崩溃。

  • 格式化输出：在序列化JSON时，根据需要选择是否进行格式化，以平衡可读性和性能。

    string compactJson = jsonObject.ToString(Newtonsoft.Json.Formatting.None);

  • 使用JToken替代JObject：在某些场景下，使用JToken可以提供更大的灵活性，尤其是在处理未知或动态的JSON结构时。 

12. 完整示例

以下是一个综合示例，涵盖了JObject的多种用法：

using Newtonsoft.Json;
using Newtonsoft.Json.Linq;
using System;
using System.IO;
using System.Linq;class Program
{static void Main(){// 示例JSONstring json = @"{'name': 'John Doe','age': 30,'address': {'street': '123 Main St','city': 'Anytown','zip': '12345'},'emails': ['john.doe@example.com','jdoe@workplace.com'],'skills': ['C#', 'JavaScript', 'SQL']}";// 解析JSON字符串JObject jsonObject = JObject.Parse(json);// 访问属性string name = (string)jsonObject["name"];int age = (int)jsonObject["age"];Console.WriteLine($"Name: {name}, Age: {age}");// 访问嵌套属性string city = (string)jsonObject["address"]["city"];Console.WriteLine($"City: {city}");// 访问数组JArray emails = (JArray)jsonObject["emails"];Console.WriteLine("Emails:");foreach (var email in emails){Console.WriteLine($" - {email}");}// 添加新属性jsonObject["isActive"] = true;// 修改属性jsonObject["age"] = 31;// 删除属性jsonObject.Remove("address");// 遍历所有属性Console.WriteLine("All properties:");foreach (var prop in jsonObject.Properties()){Console.WriteLine($"{prop.Name}: {prop.Value}");}// 使用LINQ查询技能中包含'SQL'的项目var sqlSkills = jsonObject["skills"].Where(skill => skill.ToString().Contains("SQL")).Select(skill => skill.ToString());Console.WriteLine("Skills containing 'SQL':");foreach (var skill in sqlSkills){Console.WriteLine($" - {skill}");}// 序列化回JSON字符串string updatedJson = jsonObject.ToString(Formatting.Indented);Console.WriteLine("Updated JSON:");Console.WriteLine(updatedJson);// 从C#对象创建JObjectvar newPerson = new{name = "Alice Smith",age = 28,hobbies = new[] { "Reading", "Hiking" }};JObject newPersonObject = JObject.FromObject(newPerson);Console.WriteLine("New Person JSON:");Console.WriteLine(newPersonObject.ToString());}
}

 输出：

Name: John Doe, Age: 30
City: Anytown
Emails:- john.doe@example.com- jdoe@workplace.com
All properties:
name: "John Doe"
age: 31
emails: ["john.doe@example.com","jdoe@workplace.com"
]
skills: ["C#","JavaScript","SQL"
]
isActive: true
Skills containing 'SQL':- SQL
Updated JSON:
{"name": "John Doe","age": 31,"emails": ["john.doe@example.com","jdoe@workplace.com"],"skills": ["C#","JavaScript","SQL"],"isActive": true
}
New Person JSON:
{"name": "Alice Smith","age": 28,"hobbies": ["Reading","Hiking"]
}

13. 总结

  JObject类是Json.NET库中处理JSON数据的核心组件之一，提供了丰富的功能来解析、查询和操作JSON对象。通过灵活的API和对LINQ的支持，JObject使得在C#中处理复杂的JSON结构变得简单而高效。然而，在使用JObject时，也应权衡其灵活性与性能，特别是在处理大型或性能敏感的应用场景中。

       无论是简单的JSON解析还是复杂的数据操作，掌握JObject的使用方法都将极大地提升你在C#中处理JSON数据的能力。希望本文提供的详细指南能帮助你更好地理解和应用JObject类。


http://www.ppmy.cn/ops/156347.html

相关文章

PostgreSQL 数据库备份与还原

PostgreSQL 数据库备份与还原

为了安全与数据共享等&#xff0c;创建好的数据库有时候需要备份操作和还原操作。数据库的备份与还原主要是三个命令&#xff1a;pg_dump、pg_dumpall 和 pg_restore 。 其中pg_dump用于备份单个数据库&#xff0c;它支持多种备份格式&#xff08;SQL、自定义等&#xff09;&a…
阅读更多...
c++：list

c++：list

1.list的使用 1.1构造 1.2迭代器遍历 &#xff08;1&#xff09;迭代器是算法和容器链接起来的桥梁 容器就是链表&#xff0c;顺序表等数据结构&#xff0c;他们有各自的特点&#xff0c;所以底层结构是不同的。在不用迭代器的前提下&#xff0c;如果我们的算法要作用在容器上…
阅读更多...
正则表达式超详细讲解

正则表达式超详细讲解

欢迎并且感谢大家指出我的问题&#xff0c;由于本人水平有限&#xff0c;有些内容写的不是很全面&#xff0c;只是把比较实用的东西给写下来&#xff0c;还有对一些常用的正则表达式进行收集整理&#xff0c;如果有写的不对的地方&#xff0c;还希望大家多多指教&#xff01;谢…
阅读更多...
STM32-启动文件

STM32-启动文件

STM32-启动文件 简介启动文件栈空间开辟堆空间开辟中断向量表定义复位程序 系统启动流程 简介 STM32 启动文件由 ST 官方提供&#xff0c;由汇编编写&#xff0c;是系统上电复位后执行的第一个程序。 启动文件主要做的工作。 1.初始化堆栈指针 SP _initial_sp 2.初始化程序计…
阅读更多...
Android学习20 -- 手搓App2（Gradle）

Android学习20 -- 手搓App2（Gradle）

1 前言 昨天写了一个完全手搓的&#xff1a;Android学习19 -- 手搓App-CSDN博客 后面谷歌说不要用aapt&#xff0c;d8这些来搞。其实不想弄Gradle的&#xff0c;不过想着既然开始了&#xff0c;就多看一些。之前写过一篇Gradle&#xff0c;不过是最简单的编译&#xff0c;不涉…
阅读更多...
MYSQL简单查询

MYSQL简单查询

MYSQL简单查询 完整语法&#xff1a; select [distinct] , … [from [where ] [group by , … [having ] ] [order by asc| desc ] [limit [offset , ] rows ] ] select 简单查询select 1 ; -- 往往用来 做 数据库心跳检测select user() ; -- 获取 当前登录的用户信息sele…
阅读更多...
c++ list的front和pop_front的概念和使用案例—第2版

c++ list的front和pop_front的概念和使用案例—第2版

在 C 标准库中&#xff0c;std::list 的 front() 和 pop_front() 是与链表头部元素密切相关的两个成员函数。以下是它们的核心概念和具体使用案例&#xff1a; 1. front() 方法 概念&#xff1a; 功能&#xff1a;返回链表中第一个元素的引用&#xff08;直接访问头部元素&am…
阅读更多...
一文讲解Spring中应用的设计模式

一文讲解Spring中应用的设计模式

我们都知道Spring 框架中用了蛮多设计模式的&#xff1a; 工厂模式呢&#xff0c;就是用来创建对象的&#xff0c;把对象的创建和使用分开&#xff0c;这样代码更灵活。代理模式呢&#xff0c;是用一个代理对象来控制对真实对象的访问&#xff0c;可以在访问前后做一些处理。单…
阅读更多...
最新文章

Copyright @ 2022~2023