C# 序列化与配置详解

发布时间：2026/8/11 9:58:34

C# 序列化与配置详解
上位机开发实战手册 041. 序列化选型指南1.1 常见格式对比表格式/库优点缺点适用场景JSON Newtonsoft.Json灵活、生态成熟、多态支持第三方依赖配置复杂历史项目、Web APIJSON System.Text.Json现代、高性能、UTF-8行为与 Json.NET 不同现代 .NET 项目XML XmlSerializer可读、WCF 兼容属性契约、复杂厂商 XML、SOAPCSV CsvHelper简单、易编辑功能有限数据导入导出Protobuf高性能、紧凑需要 .protogRPC、内部 RPCINI/TOML人类可读功能简单简单配置BinaryFormatter简单严重安全风险禁止新用2. Newtonsoft.Json 详解2.1 安装与引用NuGet: Newtonsoft.Json命名空间Newtonsoft.Json官方文档https://www.newtonsoft.com/json2.2 核心 API 详解JsonConvert.SerializeObject(object)参数要序列化的对象返回值JSON 字符串示例varrecipenewRecipe{Name配方A,Setpoint100.5m};stringjsonJsonConvert.SerializeObject(recipe);// 输出{Name:配方A,Setpoint:100.5}JsonConvert.SerializeObject(object, JsonSerializerSettings)参数对象、设置返回值JSON 字符串设置常用项Formatting格式化Indented缩进None紧凑NullValueHandlingnull 值处理Include/IgnoreDefaultValueHandling默认值处理Include/IgnoreMissingMemberHandling缺失成员处理Ignore/ErrorReferenceLoopHandling循环引用处理Ignore/ErrorJsonConvert.DeserializeObject(string)参数JSON 字符串返回值T 类型对象异常JsonSerializationException示例ReciperecipeJsonConvert.DeserializeObjectRecipe(json);JsonConvert.DeserializeObject(string, Type)参数JSON 字符串、目标类型返回值object2.3 JsonSerializerSettings 配置详解varsettingsnewJsonSerializerSettings{// 格式化FormattingFormatting.Indented,// null 值处理NullValueHandlingNullValueHandling.Ignore,// 默认值处理DefaultValueHandlingDefaultValueHandling.Ignore,// 缺失成员处理MissingMemberHandlingMissingMemberHandling.Error,// 日期处理DateFormatHandlingDateFormatHandling.IsoDateFormat,DateParseHandlingDateParseHandling.DateTimeOffset,// 浮点精度FloatFormatHandlingFloatFormatHandling.Symbol,// 循环引用ReferenceLoopHandlingReferenceLoopHandling.Ignore,// 文化信息CultureCultureInfo.InvariantCulture};// 添加自定义转换器settings.Converters.Add(newStringEnumConverter());settings.Converters.Add(newDecimalRoundingConverter(2));2.4 特性Attribute详解[JsonProperty(“json_name”)]作用指定 JSON 字段名示例[JsonProperty(device_id)]publicstringDeviceId{get;set;}[JsonIgnore]作用跳过该属性示例[JsonIgnore]publicboolIsDirty{get;set;}[JsonConverter(typeof(ConverterType))]作用指定自定义转换器示例[JsonConverter(typeof(StringEnumConverter))]publicEquipmentStateState{get;set;}[JsonProperty(Required Required.Always)]作用指定必填字段示例[JsonProperty(RequiredRequired.Always)]publicstringName{get;set;}2.5 动态读取 JObject/JTokenusingNewtonsoft.Json.Linq;// 解析 JSONJObjectrootJObject.Parse(json);// 读取字段stringdeviceId(string)root[deviceId];double?value(double?)root.SelectToken(result.measurement.value);// 遍历所有属性foreach(JPropertypropertyinroot.Properties()){Console.WriteLine(${property.Name}:{property.Value});}// 动态创建varobjnewJObject{[name]设备1,[status]online,[timestamp]DateTimeOffset.UtcNow};2.6 安全注意事项不要启用 TypeNameHandling.All使用 ISerializationBinder 限制反序列化类型不可信数据一律视为有害限制 JSON 大小和深度3. System.Text.Json 详解3.1 与 Newtonsoft.Json 的区别特性System.Text.JsonNewtonsoft.Json默认大小写敏感不敏感枚举处理按数字按字符串需配置字段默认忽略包含性能更高略低类型现代 .NET 内置第三方3.2 核心 API 详解JsonSerializer.Serialize(TValue, JsonSerializerOptions)参数对象、选项返回值JSON 字符串示例varoptionsnewJsonSerializerOptions{WriteIndentedtrue,PropertyNameCaseInsensitivetrue,DefaultIgnoreConditionJsonIgnoreCondition.WhenWritingNull};stringjsonJsonSerializer.Serialize(recipe,options);JsonSerializer.Deserialize(string, JsonSerializerOptions)参数JSON 字符串、选项返回值T 类型对象示例ReciperecipeJsonSerializer.DeserializeRecipe(json,options);JsonSerializerOptions 配置varoptionsnewJsonSerializerOptions{// 缩进WriteIndentedtrue,// 属性名不区分大小写PropertyNameCaseInsensitivetrue,// 属性名大小写转换PropertyNamingPolicyJsonNamingPolicy.CamelCase,// null 值处理DefaultIgnoreConditionJsonIgnoreCondition.WhenWritingNull,// 编码器EncoderJavaScriptEncoder.UnsafeRelaxedJsonEscaping};// 添加枚举转换器options.Converters.Add(newJsonStringEnumConverter());3.3 特性详解[JsonPropertyName(“json_name”)]指定 JSON 名称[JsonIgnore]跳过属性[JsonConverter(typeof(ConverterType))]自定义转换器[JsonInclude]包含字段[JsonNumberHandling]数字处理方式3.4 文档对象模型DOMusingSystem.Text.Json;usingSystem.Text.Json.Nodes;// 解析JsonObjectobjJsonNode.Parse(json).AsObject();stringdeviceId(string)obj[deviceId];// 创建varobjnewJsonObject{[name]设备1,[status]online,[timestamp]DateTimeOffset.UtcNow};4. XML 序列化4.1 XmlSerializer 详解usingSystem.Xml.Serialization;// 序列化varserializernewXmlSerializer(typeof(Recipe));using(varwriternewStreamWriter(recipe.xml,false,newUTF8Encoding(false))){serializer.Serialize(writer,recipe);}// 反序列化using(varreadernewStreamReader(recipe.xml,Encoding.UTF8)){Recipeloaded(Recipe)serializer.Deserialize(reader);}4.2 常用特性[XmlRoot(“RootName”)]根元素名[XmlElement(“ElementName”)]元素名[XmlAttribute(“AttrName”)]属性名[XmlArray(“ArrayName”)]数组名[XmlIgnore]忽略字段4.3 安全注意禁用 DTDXmlReaderSettings.DtdProcessing DtdProcessing.Prohibit禁用外部实体限制 XML 大小5. CSV 文件处理5.1 CsvHelper 详解usingCsvHelper;usingSystem.Globalization;// 读取using(varreadernewStreamReader(data.csv,Encoding.UTF8))using(varcsvnewCsvReader(reader,CultureInfo.InvariantCulture)){varrecordscsv.GetRecordsMeasurementRecord().ToList();}// 写入using(varwriternewStreamWriter(data.csv,false,newUTF8Encoding(true)))using(varcsvnewCsvWriter(writer,CultureInfo.InvariantCulture)){csv.WriteRecords(measurements);}5.2 映射类publicclassMeasurementRecord{[CsvColumn(时间)]publicDateTimeTimestamp{get;set;}[CsvColumn(数值)]publicdoubleValue{get;set;}[CsvColumn(单位)]publicstringUnit{get;set;}}5.3 手工 CSV 解析// 简单场景字段不含逗号、引号varcolumnsline.Split(new[]{,},StringSplitOptions.RemoveEmptyEntries);// 复杂场景使用 CsvHelper 或自定义解析器6. 配置文件处理6.1 appsettings.json{Device:{Host:192.168.1.10,Port:502,ConnectTimeoutSeconds:3},Database:{Path:data/device.db}}6.2 强类型配置类publicclassDeviceOptions{publicconststringSectionNameDevice;publicstringHost{get;set;}127.0.0.1;publicintPort{get;set;}502;publicintConnectTimeoutSeconds{get;set;}3;}6.3 Microsoft.Extensions.Configuration// 注册配置builder.Configuration.SetBasePath(AppContext.BaseDirectory).AddJsonFile(appsettings.json,optional:false,reloadOnChange:true).AddEnvironmentVariables(prefix:DEVICE_);// 绑定配置builder.Services.ConfigureDeviceOptions(builder.Configuration.GetSection(DeviceOptions.SectionName));// 使用配置publicclassDeviceService{privatereadonlyDeviceOptions_options;publicDeviceService(IOptionsDeviceOptionsoptions){_optionsoptions.Value;}}6.4 INI 文件处理// 简单 INI 处理publicstaticclassIniFileHelper{[DllImport(kernel32.dll,CharSetCharSet.Unicode)]privatestaticexternintGetPrivateProfileString(stringsection,stringkey,stringdefaultValue,StringBuilderreturnValue,intreturnSize,stringfileName);publicstaticstringGetValue(stringpath,stringsection,stringkey,stringdefaultValue){varsbnewStringBuilder(255);GetPrivateProfileString(section,key,defaultValue,sb,255,path);returnsb.ToString();}}7. 完整实战示例7.1 配方配置管理publicclassRecipeManager{privatereadonlystring_configPath;privatereadonlyJsonSerializerSettings_settings;publicRecipeManager(stringconfigPath){_configPathconfigPath;_settingsnewJsonSerializerSettings{FormattingFormatting.Indented,NullValueHandlingNullValueHandling.Ignore,MissingMemberHandlingMissingMemberHandling.Error,Converters{newStringEnumConverter()}};}// 读取配方publicRecipeLoad(){if(!File.Exists(_configPath))thrownewFileNotFoundException(配方文件不存在,_configPath);stringjsonFile.ReadAllText(_configPath);returnJsonConvert.DeserializeObjectRecipe(json,_settings);}// 保存配方原子写入publicvoidSave(Reciperecipe){stringjsonJsonConvert.SerializeObject(recipe,_settings);// 临时文件 替换防止写入失败损坏配置stringtempPath_configPath.tmp;File.WriteAllText(tempPath,json);try{File.Replace(tempPath,_configPath,destinationBackupFileName:null);}catch{if(File.Exists(tempPath))File.Delete(tempPath);throw;}}// 验证配方publicValidationResultValidate(Reciperecipe){if(recipenull)returnValidationResult.Fail(配方不能为空);if(string.IsNullOrWhiteSpace(recipe.Name))returnValidationResult.Fail(配方名称不能为空);if(recipe.Setpoint0||recipe.Setpoint1000)returnValidationResult.Fail(设定值必须在 0-1000 范围内);returnValidationResult.Success();}}publicclassRecipe{[JsonProperty(name,RequiredRequired.Always)]publicstringName{get;set;};[JsonProperty(description)]publicstringDescription{get;set;};[JsonProperty(setpoint)]publicdecimalSetpoint{get;set;}[JsonProperty(state)][JsonConverter(typeof(StringEnumConverter))]publicRecipeStateState{get;set;}[JsonProperty(parameters)]publicDictionarystring,decimalParameters{get;set;}new();}publicenumRecipeState{Draft,Active,Archived}publicclassValidationResult{publicboolIsValid{get;}publicstringErrorMessage{get;}privateValidationResult(boolisValid,stringerrorMessage){IsValidisValid;ErrorMessageerrorMessage;}publicstaticValidationResultSuccess()new(true,);publicstaticValidationResultFail(stringmessage)new(false,message);}

相关新闻

SpringBoot+Vue二手书商城开发实战与优化

SpringBoot+Vue二手书商城开发实战与优化

1. 项目背景与核心价值 二手书交易商城系统是当前高校学生和年轻读者群体的刚需平台。随着教材改版频率加快和阅读兴趣变化，每年产生的闲置教材、小说、专业书籍数量庞大。传统线下二手书交易存在信息不对称、交易效率低、定价混乱等问题。基于SpringBootVue的解决方…

2026/8/11 9:57:34 阅读更多 →
洛桑联邦理工Nature｜虚拟组织基础模型

洛桑联邦理工Nature｜虚拟组织基础模型

摘要 空间蛋白质组技术彻底革新了对癌症复杂组织结构的认知，但也带来独特的计算分析难题：不同研究采用差异化标志物抗体组合与实验流程，现有分析流程仅适配单一研究队列，难以跨数据集迁移知识、稳健筛选生物标志物。本文提出VirT…

2026/8/11 9:57:34 阅读更多 →
用户终身行为建模：从静态快照到动态流水的范式转变

用户终身行为建模：从静态快照到动态流水的范式转变

1. 引言：当“终身”成为用户模型的新挑战 最近在梳理用户建模领域的前沿文献时，一篇标题为《A Survey of User Lifelong Behavior Modeling: Perspectives on Efficiency and Effectiveness》的综述论文引起了我的注意。这个标题直指当前用户增长和推荐系…

2026/8/11 9:57:34 阅读更多 →

最新新闻

终极Unity包提取指南：无需编辑器快速解压.unitypackage文件

终极Unity包提取指南：无需编辑器快速解压.unitypackage文件

终极Unity包提取指南：无需编辑器快速解压.unitypackage文件 【免费下载链接】unitypackage_extractor Extract a .unitypackage, with or without Python 项目地址: https://gitcode.com/gh_mirrors/un/unitypackage_extractor 你是否曾经因为需要提取Unity资…

2026/8/11 14:58:37 阅读更多 →
2小时，我搭了一套设备保养提醒系统，再也不用靠人工记忆！

2小时，我搭了一套设备保养提醒系统，再也不用靠人工记忆！

“这个设备什么时候该保养？” “上次保养是什么时候？” “这台设备最近有没有异常？” 这几个问题，在很多制造企业里面，其实每天都在发生。 前段时间接触一家制造企业，他们有几十台生产设备，设备…

2026/8/11 14:58:37 阅读更多 →
树洞 OCR：你的本地化跨平台文字识别利器

树洞 OCR：你的本地化跨平台文字识别利器

树洞 OCR：你的本地化跨平台文字识别利器 【免费下载链接】tools-ocr 树洞 OCR 文字识别（一款跨平台的 OCR 小工具） 项目地址: https://gitcode.com/gh_mirrors/to/tools-ocr 还在为截图转文字烦恼吗？树洞 OCR 或许就是你一…

2026/8/11 14:58:37 阅读更多 →
Nucleus Co-op终极指南：如何用一台电脑实现800+游戏本地分屏联机

Nucleus Co-op终极指南：如何用一台电脑实现800+游戏本地分屏联机

Nucleus Co-op终极指南：如何用一台电脑实现800游戏本地分屏联机 【免费下载链接】splitscreenme-nucleus Nucleus Co-op is an application that starts multiple instances of a game for split-screen multiplayer gaming! 项目地址: https://gitcode.com/gh_mi…

2026/8/11 14:58:37 阅读更多 →
《2026 智能机器人产业白皮书》深度解读：硬件、模型与场景落地全洞察

《2026 智能机器人产业白皮书》深度解读：硬件、模型与场景落地全洞察

前言 2026 年，智能机器人行业正式从实验室技术验证，迈入商业化规模化落地的关键周期。普华永道发布的《2026 年智能机器人产业发展白皮书》，围绕国内机器人产业链供给、市场场景、技术路线、产业价值四大维度完成系统性拆解，避开…

2026/8/11 14:58:37 阅读更多 →
Python-for-Android：为什么Python开发者应该选择它而非传统Android开发方案

Python-for-Android：为什么Python开发者应该选择它而非传统Android开发方案

Python-for-Android：为什么Python开发者应该选择它而非传统Android开发方案 【免费下载链接】python-for-android Turn your Python application into an Android APK 项目地址: https://gitcode.com/gh_mirrors/py/python-for-android 对于数百万Python开发…

2026/8/11 14:57:36 阅读更多 →

日新闻

如何用Video2X实现专业级视频画质提升：AI视频增强完整指南

如何用Video2X实现专业级视频画质提升：AI视频增强完整指南

如何用Video2X实现专业级视频画质提升：AI视频增强完整指南 【免费下载链接】video2x A machine learning-based video super resolution and frame interpolation framework. Est. Hack the Valley II, 2018. 项目地址: https://gitcode.com/GitHub_Trending/vi/v…

2026/8/11 0:00:02 阅读更多 →
前后端分离项目中控制台与接口工具数据差异排查指南

前后端分离项目中控制台与接口工具数据差异排查指南

1. 问题现象解析：控制台与Apifox的数据差异 最近在调试一个前后端分离项目时，遇到了一个典型问题：后端服务在本地开发环境控制台能正常输出查询数据，但通过Apifox测试时却返回空结果。这种"控制台有数据，接口工具…

2026/8/11 0:00:03 阅读更多 →
AI编程实战：从Claude Code踩坑到游戏开发入门

AI编程实战：从Claude Code踩坑到游戏开发入门

1. 从“AI能帮我做游戏”到“AI让我重新学编程”最近身边不少朋友，尤其是一些非技术背景、但对游戏开发有浓厚兴趣的朋友，都在问我同一个问题：“听说现在用Claude Code这种AI编程工具，小白也能做游戏了，是真的吗&#…

2026/8/11 0:00:03 阅读更多 →

周新闻

5分钟告别提取码焦虑：baidupankey如何智能破解百度网盘资源锁

5分钟告别提取码焦虑：baidupankey如何智能破解百度网盘资源锁

5分钟告别提取码焦虑：baidupankey如何智能破解百度网盘资源锁 【免费下载链接】baidupankey 在线查询网盘提取码（维护中 rm repo） 项目地址: https://gitcode.com/gh_mirrors/ba/baidupankey 你是否曾经在深夜寻找一份重要资料&#x…

2026/8/11 1:08:05 阅读更多 →
如何快速生成中国车牌图片：Python开源工具完整指南

如何快速生成中国车牌图片：Python开源工具完整指南

如何快速生成中国车牌图片：Python开源工具完整指南 【免费下载链接】chinese_license_plate_generator 中国车牌生成器 项目地址: https://gitcode.com/gh_mirrors/ch/chinese_license_plate_generator 中国车牌生成器是一个基于Python的开源项目&#xff0c…

2026/8/11 1:08:05 阅读更多 →
收藏！小白程序员轻松入门大模型，从Harness工程开始实践

收藏！小白程序员轻松入门大模型，从Harness工程开始实践

文章强调学习大模型不应只关注模型本身，而应重视模型外的系统搭建，即Harness。提出AgentModelHarness的实用公式，详细介绍Harness的四个层次：持久化层、执行层、控制层和观察与验证层。文章还探讨了上下文工程、工具设计、AGENTS.…

2026/8/11 1:08:05 阅读更多 →

月新闻

免费解锁百度网盘SVIP加速：macOS用户必备的下载提速终极指南

免费解锁百度网盘SVIP加速：macOS用户必备的下载提速终极指南

免费解锁百度网盘SVIP加速：macOS用户必备的下载提速终极指南 【免费下载链接】BaiduNetdiskPlugin-macOS For macOS.百度网盘 破解SVIP、下载速度限制~ 项目地址: https://gitcode.com/gh_mirrors/ba/BaiduNetdiskPlugin-macOS 还在为百度网盘macOS版的龟速下…

2026/8/10 17:07:33 阅读更多 →
终极ncmdump指南：3分钟实现网易云NCM音乐解密与格式转换

终极ncmdump指南：3分钟实现网易云NCM音乐解密与格式转换

终极ncmdump指南：3分钟实现网易云NCM音乐解密与格式转换 【免费下载链接】ncmdump 项目地址: https://gitcode.com/gh_mirrors/ncmd/ncmdump 还在为网易云音乐下载的NCM格式文件无法在其他播放器播放而烦恼吗？ncmdump解密工具帮你轻松解决这个困…

2026/8/11 1:08:06 阅读更多 →
HarmonyOS 应用开发《掌上英语》第81篇: 智能体卡片：为英语学习 App 打造桌面级学习助手

HarmonyOS 应用开发《掌上英语》第81篇: 智能体卡片：为英语学习 App 打造桌面级学习助手

AgentCard 智能体卡片：为英语学习 App 打造桌面级学习助手适用平台：HarmonyOS 7.0 (API 26 Beta)一、引言 HarmonyOS 7.0（API 26 Beta）新增了 AgentCard 智能体卡片能力，这是继 HMAF（鸿蒙智能体框架&#x…

2026/8/10 17:07:33 阅读更多 →