【C# 序列化】Json序列化器
2022/3/19 9:27:43
本文主要是介绍【C# 序列化】Json序列化器,对大家解决编程问题具有一定的参考价值,需要的程序猿们随着小编来一起学习吧!
命名空间
System.Text.Json:默认情况下,System.Text.Json使用运行时反射来收集它需要访问序列化和反序列化对象的属性的元数据。作为一种替代方法,System.Text.Json 6.0可以使用c#源生成器特性来提高性能,减少私有内存的使用,并简化程序组装,从而减少应用程序大小。例如在asp.net中可以读取 XML、JSON 直接生成 C# 代码参与编译,DTO 编写全自动化都是没问题的。编译时反射 - 0 运行时开销。
.NET 6 中的 System.Text.Json 已做了许多改进,因此它现在是一个“工业强度”的序列化解决方案。
源生成器
.NET 6 为 添加了新的源生成器。 源生成可与 JsonSerializer 配合使用,并且可以通过多种方式进行配置。 它可以提高性能、减少内存使用量并便于程序集剪裁。 有关详细信息,请参阅如何在 System.Text.Json 中选择反射或源生成以及如何在 System.Text.Json 中使用源生成。
System.Text.Json.Nodes
System.Text.Json.Serialization
JSON简介
JSON 是一种数据格式,已成为 XML 的流行替代品。它简单而整洁,语法类似于 JavaScript 对象。实际上,术语 JSON 代表 JavaScript Object Notation。.NET 的最新版本为处理 JSON 数据提供了内置支持。
System.Text.Json 命名空间提供高性能、低分配的功能来处理 JSON 数据。这些功能包括将对象序列化为 JSON 并将 JSON 反序列化为对象。它还提供用于创建内存中文档对象模型 (DOM) 的类型,用于访问 JSON 文档中的任何元素,提供数据的结构化视图。
支持 System.Runtime.Serialization
特性。System.Text.Json
中不支持 System.Runtime.Serialization 命名空间中的特性。
详细请查看 【C# 序列化】 JSON-在.net croe中的应用
Text.Json支持的格式
JSON 数据的书写格式是:名称/值对,数据由逗号分隔。.net core 对json 的处理默认使用驼峰式,
JSON 值可以是:
数字(整数或浮点数)
字符串(在双引号中)
逻辑值(true 或 false)
数组(在方括号中)[,]
对象(在花括号中){}
null
public class Serializeables { public DateTimeOffset Date { get; set; } public int TemperatureCelsius { get; set; } public string Ser = "first ser"; public bool Sers = true; public bool[] Serbool = { true ,true,true}; public List<SerrializePeople> SerList = new(); } //输出 /*{ "Date": "0001-01-01T00:00:00+00:00", "TemperatureCelsius": 0, "Ser": "first ser", "Sers": true, "Serbool": [true, true, true], "SerList": [{ "Person": null }, { "Person": null }] } */
Json序列化器 简介
功能
了具有以下功能的JsonSerializer
:
- 支持对简单传统CLR对象(POCO)、基元类型、集合进行序列化和反序列化;
- 内置的异步序列化和反序列化;
- 原生处理UTF-8数据;
- 反序列化可选是否区分大小写;
- 使用
JsonNamingPolicy.CamelCase
的驼峰命名策略; - 使用
JsonNamingPolicy
指定自定义命名策略; - 转义的JSON数据反序列化;
- 序列化时可选的最小字符转义;
- 序列化时忽略空值;
- 反序列化时忽略注释;
- 允许(JSON)尾随逗号;
- 可定制转换器;
- 使用
[JsonExtensionData]
特性指示在反序列化时没有匹配成员的属性存放处(a property overflow bag);(注:当属性的类型为IDictionary<TKey,TValue>
时,没有匹配成员的任何属性都会在反序列化期间添加到该字典中,并在序列化期间中写入) - 使用
[JsonIgnore]
特性忽略特定的属性; - 使用
[JsonProperty]
特性来指定自定义属性名。(注:未使用[JsonProperty]
特性时Json对应的实体类属性名需要与Json对应属性完全一致,使用[JsonProperty]
特性标识PropertyName
后,实体类属性名可自定义)
序列化选项设置
- 实例化 JsonSerializerOptions
- 重用 JsonSerializerOptions 实例
- 复制 JsonSerializerOptions
- JsonSerializerOptions 的 Web 默认值
- 反序列化启用不区分大小写的匹配
- 自定义Json属性名称和值
- 自定义单个属性名称
- 对所有 JSON 属性名称使用 camel 大小写
- 使用
[JsonPropertyName("Wind")]
自定义 JSON 属性命名策略 JsonStringEnumConverter
()将字典键Key的作为Json属性的命名规则- 枚举项做为Json属性的命名规则
- 使用[JsonPropertyOrder(数值)]自定义序列化Json属性的顺序
- 忽略属性
- 忽略单个属性,使用[JsonIgnore] 特性和JsonIgnoreCondition枚举类忽略当个属性
- 忽略所有只读属性
- 忽略所有 null 值属性
- 忽略所有默认值属性
- 允许无效的 JSON
- 允许注释和尾随逗号
- 允许或写入带引号的数字
- 处理溢出 JSON,使用 JsonElement 或 JsonNode
- 处理溢出 JSON
- 反序列化为 JsonElement 或 JsonNode
- 保留引用,处理循环引用
- 保留引用并处理循环引用 将元数据属性写入 (
$id
、$values
和$ref
)ReferenceHandler = ReferenceHandler.Preserve,
- 跨多个序列化和反序列化调用保留引用元数据(不理解,赶紧用不到)
- 忽略循环引用
ReferenceHandler = ReferenceHandler.IgnoreCycles,
- 保留引用并处理循环引用 将元数据属性写入 (
- 反序列化为不可变类型,非公共访问器
- 不可变类型和记录
- 非公共属性访问器
- 多态序列化 本文介绍的是序列化,而不是反序列化。 不支持多态反序列化,解决方法是,你编写一个自定义转换器,例如支持多态反序列化中的示例。不过已经不需要写反序列化类型,.net6.0可以直接使用Writable Dom。
【C# 序列化】序列化控制 JsonProperty 结构
序列化控制
内容来源:https://docs.microsoft.com/zh-cn/dotnet/standard/serialization/system-text-json-configure-options?pivots=dotnet-6-0
Text.Json新增了4个接口
IJsonOnDeserialized代替[OnSerialized]
IJsonOnDeserializing代替[OnSerializing]
IJsonOnSerialized代替[OnDeserialized]
IJsonOnSerializing代替[OnDeserializing]
IJsonOnDeserializing, IJsonOnDeserialized, IJsonOnSerializing, IJsonOnSerialized public class Serializeables : IJsonOnDeserializing, IJsonOnDeserialized,IJsonOnSerializing, IJsonOnSerialized { public bool[] Serbool = { true, true, true }; public void OnSerializing() => Console.WriteLine("序列化中"); public void OnDeserializing() => Console.WriteLine("反序列化中"); public void OnDeserialized() => Console.WriteLine("反序列化后"); public void OnSerialized() => Console.WriteLine("序列化后"); }
[JsonIgnore] 特性 忽略属性
“序列化通知”功能对于设置默认值和验证属性值合法性非常有用。
JsonIgnoreCondition Enum
Always 1 属性将始终被忽略。
Never 0 属性将始终被序列化和反序列化,无论IgnoreNullValues配置如何。无论 DefaultIgnoreCondition
、IgnoreReadOnlyProperties
和 IgnoreReadOnlyFields
全局设置如何,始终序列化和反序列化属性。
WhenWritingDefault 2 属性只有在为空时才会被忽略。如果属性是引用类型 null
可为 null 的值类型 null
或值类型 default
,则在序列化中忽略属性。
WhenWritingNull 3 如果该值为空,则在序列化期间忽略该属性。这只适用于引用类型的属性和字段。WhenWritingNull
- 如果属性是引用类型 null
或可为 null 的值类型 null
,则在序列化中忽略属性。
public class MySerializeable { [JsonIgnore(Condition =JsonIgnoreCondition.Always)] public string Name = "dfdf";//被忽略 [JsonIgnore(Condition =JsonIgnoreCondition.Never)] public string Name2 = "dfdf"; [JsonIgnore(Condition =JsonIgnoreCondition.WhenWritingDefault)] public string Name3 = default;//将被忽略,因为使用默认值 [JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingNull)] public string Name4 =null;//会被忽略因为null }
综合使用案例
using System.Text.Encodings.Web; using System.Text.Json; using System.Text.Json.Nodes; using System.Text.Json.Serialization; using System.Text.Unicode; JsonSerializerOptions jso = new JsonSerializerOptions { WriteIndented = true, PropertyNameCaseInsensitive = true, DictionaryKeyPolicy = JsonNamingPolicy.CamelCase, DefaultIgnoreCondition = JsonIgnoreCondition.WhenWritingNull, ReadCommentHandling = JsonCommentHandling.Skip, //跳过注释 AllowTrailingCommas = true,//忽略逗号 PropertyNamingPolicy = JsonNamingPolicy.CamelCase,//属性名的格式,驼峰 NumberHandling = JsonNumberHandling.AllowReadingFromString,//反序列化的时候用的到 IncludeFields=true, //保证中文字符正确显示。CjkUnifiedIdeographs 象行文字 代表中文(Chinese)、日文(Japanese )、韩文(Korean)的字符集合 Encoder = JavaScriptEncoder.Create(UnicodeRanges.BasicLatin, UnicodeRanges.CjkUnifiedIdeographs),//从拉丁文字到象行文字 }; var json=JsonSerializer.SerializeToNode(new Myserliazer("祖海", "Summary", "Summary", "Summary"),jso); Console.WriteLine(json.ToJsonString(options: jso)); public class Myserliazer { public Myserliazer() { } [JsonConstructor] public Myserliazer(string name, string sumary, string description, string keyword) => (Name, Summary, Description, KeyWord) = (name, sumary, description, keyword); //[JsonInclude] 用法 [JsonInclude] public string Name = "董卿"; [JsonInclude]//若要允许使用非公共属性访问器,请使用 [JsonInclude] 特性 public string? Summary { private get; set; } = "Summary"; [JsonInclude] public string Content { get; private set; } = @"[OnSerialized()] internal void OnSerializedMethod(StreamingContext context) ... the call to the onSerializing method when the serialized objects are equal."; public string Frend = "哈哈"; //[JsonIgnore]用法 public string Description { get; set; } = "My first int"; [JsonIgnore(Condition = JsonIgnoreCondition.Never)] public string KeyWord { get; set; } = "Web Site"; [JsonIgnore(Condition = JsonIgnoreCondition.Always)] public DateTime DateTimenow { get; set; } = DateTime.Now; public string Eeditor{ get; } // [JsonExtensionData]用法 [JsonExtensionData] public Dictionary<string, JsonElement>? ExtensionData { get; set; } = new Dictionary<string, JsonElement>(); // [JsonPropertyName]用法 [JsonPropertyName("Cangpr0pety")] public string ChangPr0pety { set; get; } = "ChangPr0pety"; public int Age { set; get; } = 12; public void OnDeserializing() { throw new NotImplementedException(); } }
这篇关于【C# 序列化】Json序列化器的文章就介绍到这儿,希望我们推荐的文章对大家有所帮助,也希望大家多多支持为之网!
- 2022-03-01沐雪多租宝商城源码从.NetCore3.1升级到.Net6的步骤
- 2024-12-06使用Microsoft.Extensions.AI在.NET中生成嵌入向量
- 2024-11-18微软研究:RAG系统的四个层次提升理解与回答能力
- 2024-11-15C#中怎么从PEM格式的证书中提取公钥?-icode9专业技术文章分享
- 2024-11-14云架构设计——如何用diagrams.net绘制专业的AWS架构图?
- 2024-05-08首个适配Visual Studio平台的国产智能编程助手CodeGeeX正式上线!C#程序员必备效率神器!
- 2024-03-30C#设计模式之十六迭代器模式(Iterator Pattern)【行为型】
- 2024-03-29c# datetime tryparse
- 2024-02-21list find index c#
- 2024-01-24convert toint32 c#