C#解析JSON数据全攻略指南
更新时间：2025年07月22日 15:50:58 作者：曲幽
这篇文章主要为大家详细介绍了使用C#解析JSON数据全攻略指南,文中的示例代码讲解详细,感兴趣的小伙伴可以跟随小编一起学习一下
还在为C#处理网络API返回的复杂JSON数据头疼吗？据统计，90%的开发者都曾在JSON解析上栽过跟头！
本文将手把手教你用C#轻松玩转JSON数据：
- HttpClient获取网络JSON数据
- System.Text.Json动态解析技巧
- 强类型模型转换实战
- 特殊字符/日期格式处理方案
- 完整可运行代码示例
一、为什么JSON是C#开发必修课？
现代Web API中95%的数据交换采用JSON格式。无论是调用天气API、支付接口，还是处理云服务返回数据，JSON解析都是核心技能！
二、四步搞定网络JSON数据
1. 获取数据 - HttpClient最佳实践
using var httpClient = new HttpClient();
var response = await httpClient.GetAsync("https://api.example.com/data");
var jsonString = await response.Content.ReadAsStringAsync();关键点：使用using自动释放资源，异步方法提升性能
2. 动态解析 - 快速读取字段
using System.Text.Json;
var jsonDoc = JsonDocument.Parse(jsonString);
string name = jsonDoc.RootElement
.GetProperty("user")
.GetProperty("name")
.GetString();适用场景：快速提取少量字段，无需创建完整模型
3. 强类型解析 - 推荐方案！
public class User {
public string Name { get; set; }
public int Age { get; set; }
public DateTime RegisterDate { get; set; }
}
var user = JsonSerializer.Deserialize<User>(jsonString, new JsonSerializerOptions {
PropertyNameCaseInsensitive = true // 忽略大小写
});优势：编译时检查 + 智能提示 + 高可维护性
4. 特殊场景处理
日期格式转换：
options.Converters.Add(new DateTimeConverter("yyyy-MM-dd"));处理JSON注释：
options.ReadCommentHandling = JsonCommentHandling.Skip;
三、避坑指南
- NULL引用异常：给属性设置默认值 public string Name { get; set; } = string.Empty;
- 字段缺失：使用[JsonIgnore]忽略不存在的属性
- 性能陷阱：大文件解析用JsonDocument替代JObject
四、完整代码示例
using System.Text.Json;
public async Task<WeatherData> GetWeatherAsync() {
using var httpClient = new HttpClient();
// 获取杭州天气数据
var response = await httpClient.GetAsync(
"https://api.weather.com/v3?location=hangzhou");
response.EnsureSuccessStatusCode();
var json = await response.Content.ReadAsStringAsync();
// 强类型解析
return JsonSerializer.Deserialize<WeatherData>(json, new JsonSerializerOptions {
PropertyNameCaseInsensitive = true,
NumberHandling = JsonNumberHandling.AllowReadingFromString
});
}
// 定义数据模型
public class WeatherData {
public string Location { get; set; } = string.Empty;
public double Temperature { get; set; }
public string Unit { get; set; } = "Celsius";
[JsonPropertyName("wind_speed")]
public double WindSpeed { get; set; }
}五、知识延展
C#中处理JSON数据的方式
1.将对象序列化为JSON字符串
在C#中，可以使用System.Text.Json和Newtonsoft.Json这两个流行的库来将对象序列化为JSON字符串。以下是使用这两个库进行序列化的示例代码：
using System;
using System.Text.Json;
using Newtonsoft.Json;
public class Person
{
public string Name { get; set; }
public int Age { get; set; }
}
public class Program
{
public static void Main()
{
Person person = new Person { Name = "John Doe", Age = 30 };
// 使用System.Text.Json库进行序列化
string json1 = JsonSerializer.Serialize(person);
Console.WriteLine(json1);
// 使用Newtonsoft.Json库进行序列化
string json2 = JsonConvert.SerializeObject(person);
Console.WriteLine(json2);
}
}2.将JSON字符串反序列化为对象
与将对象序列化为JSON字符串相反，C#中也可以使用System.Text.Json和Newtonsoft.Json来将JSON字符串反序列化为对象。以下是使用这两个库进行反序列化的示例代码：
using System;
using System.Text.Json;
using Newtonsoft.Json;
public class Person
{
public string Name { get; set; }
public int Age { get; set; }
}
public class Program
{
public static void Main()
{
string json = "{\"Name\":\"John Doe\",\"Age\":30}";
// 使用System.Text.Json库进行反序列化
Person person1 = JsonSerializer.Deserialize<Person>(json);
Console.WriteLine(person1.Name);
Console.WriteLine(person1.Age);
// 使用Newtonsoft.Json库进行反序列化
Person person2 = JsonConvert.DeserializeObject<Person>(json);
Console.WriteLine(person2.Name);
Console.WriteLine(person2.Age);
}
}3.对JSON进行查询和筛选
在C#中，我们可以使用LINQ（Language-Integrated Query）来对JSON进行查询和筛选。通过使用SelectToken方法和JsonPath表达式，我们可以方便地访问和操作嵌套的JSON属性。以下是一个使用LINQ查询和筛选JSON的示例：
using System;
using Newtonsoft.Json.Linq;
public class Program
{
public static void Main()
{
string json = "{\"Name\":\"John Doe\",\"Age\":30,\"Address\":{\"City\":\"New York\",\"Country\":\"USA\"}}";
JObject obj = JObject.Parse(json);
// 使用JsonPath表达式查询和筛选JSON
JToken nameToken = obj.SelectToken("$.Name");
Console.WriteLine(nameToken.Value<string>());
JToken addressToken = obj.SelectToken("$.Address");
Console.WriteLine(addressToken["City"].Value<string>());
Console.WriteLine(addressToken["Country"].Value<string>());
}
}4.使用LINQ操作JSON数据
除了查询和筛选，我们还可以使用LINQ来对JSON数据进行各种操作，例如投影、连接和排序等。以下是一个使用LINQ操作JSON数据的示例：
using System;
using System.Linq;
using Newtonsoft.Json.Linq;
public class Program
{
public static void Main()
{
string json = "[{\"Name\":\"John Doe\",\"Age\":30},{\"Name\":\"Jane Smith\",\"Age\":35}]";
JArray array = JArray.Parse(json);
// 使用LINQ查询和操作JSON数据
var names = from item in array
select item["Name"].Value<string>();
foreach (string name in names)
{
Console.WriteLine(name);
}
}
}5.处理复杂的嵌套JSON结构
在处理复杂的嵌套JSON结构时，可以使用JObject和JArray类来方便地访问和操作JSON数据。这两个类提供了一系列方法和属性，用于处理嵌套的JSON对象和数组。以下是一个处理复杂嵌套JSON结构的示例：
using System;
using Newtonsoft.Json.Linq;
public class Program
{
public static void Main()
{
string json = "{\"Name\":\"John Doe\",\"Age\":30,\"Address\":{\"City\":\"New York\",\"Country\":\"USA\"},\"Languages\":[\"C#\",\"JavaScript\"]}";
JObject obj = JObject.Parse(json);
Console.WriteLine(obj["Name"].Value<string>());
Console.WriteLine(obj["Age"].Value<int>());
Console.WriteLine(obj["Address"]["City"].Value<string>());
Console.WriteLine(obj["Address"]["Country"].Value<string>());
foreach (string language in obj["Languages"])
{
Console.WriteLine(language);
}
}
}6.处理日期和时间类型的JSON数据
当JSON中包含日期和时间类型的数据时，可以使用DateTimeOffset和JsonConvert类来进行正确的处理和转换。以下是一个处理日期和时间类型的JSON数据的示例：
using System;
using Newtonsoft.Json;
public class Person
{
public string Name { get; set; }
public DateTimeOffset BirthDate { get; set; }
}
public class Program
{
public static void Main()
{
string json = "{\"Name\":\"John Doe\",\"BirthDate\":\"1980-01-01T00:00:00+00:00\"}";
// 使用Newtonsoft.Json处理日期和时间类型
Person person = JsonConvert.DeserializeObject<Person>(json);
Console.WriteLine(person.Name);
Console.WriteLine(person.BirthDate);
}
}7.处理JSON中的特殊字符和转义序列
当处理包含特殊字符和转义序列的JSON数据时，可以使用JsonConvert类的EscapeString方法来进行正确的转义。以下是一个处理特殊字符和转义序列的JSON数据的示例：
using System;
using Newtonsoft.Json;
public class Program
{
public static void Main()
{
string text = @"This is a \"quoted\" text.";
string json = JsonConvert.SerializeObject(text);
Console.WriteLine(json); // 输出："This is a \\\\\"quoted\\\\\" text."
}
}8.处理大量的JSON数据
当处理包含大量JSON数据时，可以使用JsonReader和JsonWriter类来实现流式处理，从而减少内存占用和提高性能。以下是一个处理大量JSON数据的示例：
using System;
using System.IO;
using Newtonsoft.Json;
public class Person
{
public string Name { get; set; }
public int Age { get; set; }
}
public class Program
{
public static void Main()
{
string[] names = {"John", "Jane", "Tom", "Alice"};
using (var stream = new StreamWriter("data.json"))
using (var writer = new JsonTextWriter(stream))
{
writer.WriteStartArray();
foreach (string name in names)
{
var person = new Person {Name = name, Age = 30};
JsonSerializer.Serialize(writer, person);
}
writer.WriteEndArray();
}
}
}9.处理JSON中的异常和错误情况
在处理JSON数据时，可能会遇到各种异常和错误情况。为了确保代码的健壮性和可靠性，应该使用try-catch语句来捕获和处理异常。以下是一个处理JSON异常和错误情况的示例：
using System;
using Newtonsoft.Json;
public class Program
{
public static void Main()
{
try
{
string invalidJson = "This is not a valid JSON.";
dynamic obj = JsonConvert.DeserializeObject(invalidJson);
}
catch (JsonReaderException ex)
{
Console.WriteLine("JSON解析错误：" + ex.Message);
}
catch (JsonSerializationException ex)
{
Console.WriteLine("JSON序列化错误：" + ex.Message);
}
}
}最佳实践和性能优化建议
在处理JSON数据时，遵循以下最佳实践和性能优化建议可以提高代码的可读性和性能：
- 尽可能使用System.Text.Json库，它是.NET Core的默认JSON库，性能比Newtonsoft.Json更好。
- 对于复杂的嵌套JSON结构，使用JObject和JArray类进行访问和操作。
- 对于大量的JSON数据，使用JsonReader和JsonWriter类进行流式处理。
- 使用LINQ查询和操作JSON数据，使代码更简洁和可读。
- 避免在循环内进行重复的JSON序列化和反序列化操作，尽量缓存结果。
到此这篇关于C#解析JSON数据全攻略指南的文章就介绍到这了,更多相关C#解析JSON内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家！
相关文章
今天小编就为大家分享一篇C#判断获取的是文件夹还是文件的实例，具有很好的参考价值，希望对大家有所帮助。一起跟随小编过来看看吧2019-06-06
这篇文章主要介绍了C#中Linq延迟查询的例子,本文用一个实例来讲解延迟查询的使用,需要的朋友可以参考下2015-06-06
在现代计算机系统中,串口通信仍然是许多设备和应用程序之间进行数据交换的重要方式,无论是在工业自动化、嵌入式系统,还是在日常的硬件调试中,串口都扮演着不可或缺的角色,本文旨在深入探讨C#中串口读取问题的常见原因,并提供一系列有效的解决方案,需要的朋友可以参考下2024-12-12
这篇文章主要为大家详细介绍了C#操作INI配置文件示例，具有一定的参考价值，感兴趣的小伙伴们可以参考一下2017-07-07
这篇文章主要介绍了Unity 如何获取鼠标停留位置下的物体，具有很好的参考价值，希望对大家有所帮助。一起跟随小编过来看看吧2021-04-04
这篇文章主要介绍了C# StartsWith 字符串的实例方法,StartsWith 方法对于需要检查字符串的前缀是否匹配特定模式的情况非常有用,你可以根据返回的布尔值,根据需要执行相应的逻辑操作,需要的朋友可以参考下2024-03-03
这篇文章主要介绍了C# 线程同步的的相关资料，文中讲解非常细致，代码帮助大家更好的理解和学习，感兴趣的朋友可以了解下2020-06-06
这篇文章主要介绍了C#实现的json序列化和反序列化代码实例,本文讲解了两种实现方法,并直接给出代码示例,需要的朋友可以参考下2015-06-06
下面小编就为大家分享一篇找到整型阵列中最大值和最小值的几种方法总结，具有很好的参考价值，希望对大家有所帮助。一起跟随小编过来看看吧2017-12-12
这篇文章主要介绍了C#中闭包概念讲解,本篇文章通过简要的案例,讲解了该项技术的了解与使用,以下就是详细内容,需要的朋友可以参考下2021-07-07
最新评论