0

0

C# XDocument Save SaveOptions.None 默认保存选项

幻夢星雲

幻夢星雲

发布时间:2026-03-09 08:28:03

|

233人浏览过

|

来源于php中文网

原创

saveoptions.none会删除格式性空白节点但保留显式字符串;真正保留缩进需加载时用loadoptions.preservewhitespace并保存时用saveoptions.disableformatting或format。

c# xdocument save saveoptions.none 默认保存选项

SaveOptions.None 会删除空白节点,但不是所有空白

SaveOptions.NoneXDocument.Save 的默认选项,它会让序列化过程“忽略”某些空白文本节点——但仅限于那些被判定为「格式性空白」(即仅由空格、换行、制表符组成,且父元素有子元素时出现在元素之间)的节点。它不会动你显式写入的 " ""\n" 字符串内容。

常见错误现象:XML 文件保存后缩进没了、换行消失了、相邻标签“粘连”在一起,比如 <name>Alice</name><age>30</age> 而不是分行显示。

  • 这是预期行为,不是 bug —— SaveOptions.None 的设计目标就是紧凑输出
  • 如果你用 XElement.Parse("<root>\n <a></a>\n <b></b>\n</root>") 创建树,那些换行和缩进在解析阶段就已被当作格式空白丢弃,SaveOptions.None 只是不额外加回来
  • 真正保留原始缩进需用 SaveOptions.DisableFormatting,但它只对「已存在」的空白节点起作用;如果解析时空白已丢失,保存时也救不回来

想保留换行缩进?别只靠 SaveOptions

仅设置 SaveOptions.Format 不足以让 XML 看起来“美观”。它只控制是否在元素间插入换行和缩进,前提是:树中已有足够的空白节点支撑格式化逻辑。

使用场景:调试输出、生成人可读配置文件、和外部系统做 diff 对比。

Stable Diffusion 2.1 Demo
Stable Diffusion 2.1 Demo

最新体验版 Stable Diffusion 2.1

下载
  • SaveOptions.Format 会在每个元素开始标签后、结束标签前插入换行+缩进,但不会在文本内容里插空格
  • 若你用 new XElement("root", new XElement("a"), new XElement("b")) 构造,没手动加 XText("\n "),那即使选 Format,结果仍是紧凑的
  • 真正可控的方式是:构造时显式插入格式节点,或用 XDocument.ToString(SaveOptions.Format)(注意:ToString() 不走 Save() 流程,行为略有差异)

SaveOptions.DisableFormatting 和 Format 的关键区别

SaveOptions.DisableFormatting 不是“关闭格式化”,而是“禁用自动格式化逻辑”——它原样保留你在 XML 树中手动添加的所有 XText 节点,包括空格、换行、甚至不可见字符。

SaveOptions.Format 是主动注入格式,不管原来有没有。

  • DisableFormatting 前,必须确保你构造树时已经插入了想要的空白,例如:new XElement("root", "\n ", new XElement("a"), "\n ", new XElement("b"), "\n")
  • Format 在保存时动态计算缩进层级,适合快速美化,但无法控制具体缩进宽度(固定为 2 空格)
  • 两者都不影响属性顺序、命名空间声明位置等底层细节;这些由 XDocument 内部状态决定,无法通过 SaveOptions 调整

常见误用:以为 SaveOptions 能修复解析时丢失的空白

很多人试图用 SaveOptions.Format 把从文件读进来的 XML “变好看”,却发现没变化。问题往往出在解析阶段:用 XDocument.Load(path) 默认启用 LoadOptions.PreserveWhitespace 吗?不,默认是 None,也就是丢弃格式空白。

  • 正确做法:加载时明确指定 LoadOptions.PreserveWhitespace,例如:XDocument.Load(path, LoadOptions.PreserveWhitespace)
  • 否则,即使后续用 Format 保存,也只能格式化“现有结构”,没有空白节点可格式化
  • 验证方法:断点查看 doc.Root.Nodes(),里面是否有 XText 类型节点,且 Value 包含换行符

空白处理是分两段的事:加载时留不留,保存时加不加。SaveOptions 只管后半段,前半段得自己把关。

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

通义千问
通义千问

阿里巴巴推出的全能AI助手

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
format在python中的用法
format在python中的用法

Python中的format是一种字符串格式化方法,用于将变量或值插入到字符串中的占位符位置。通过format方法,我们可以动态地构建字符串,使其包含不同值。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

887

2023.07.31

python中的format是什么意思
python中的format是什么意思

python中的format是一种字符串格式化方法,用于将变量或值插入到字符串中的占位符位置。通过format方法,我们可以动态地构建字符串,使其包含不同值。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

459

2024.06.27

pdf怎么转换成xml格式
pdf怎么转换成xml格式

将 pdf 转换为 xml 的方法:1. 使用在线转换器;2. 使用桌面软件(如 adobe acrobat、itext);3. 使用命令行工具(如 pdftoxml)。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

1945

2024.04.01

xml怎么变成word
xml怎么变成word

步骤:1. 导入 xml 文件;2. 选择 xml 结构;3. 映射 xml 元素到 word 元素;4. 生成 word 文档。提示:确保 xml 文件结构良好,并预览 word 文档以验证转换是否成功。想了解更多xml的相关内容,可以阅读本专题下面的文章。

2119

2024.08.01

xml是什么格式的文件
xml是什么格式的文件

xml是一种纯文本格式的文件。xml指的是可扩展标记语言,标准通用标记语言的子集,是一种用于标记电子文件使其具有结构性的标记语言。想了解更多相关的内容,可阅读本专题下面的相关文章。

1166

2024.11.28

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

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

739

2023.08.03

js截取字符串的方法
js截取字符串的方法

js截取字符串的方法有substring()方法、substr()方法、slice()方法、split()方法和slice()方法。本专题为大家提供字符串相关的文章、下载、课程内容,供大家免费下载体验。

220

2023.09.04

java基础知识汇总
java基础知识汇总

java基础知识有Java的历史和特点、Java的开发环境、Java的基本数据类型、变量和常量、运算符和表达式、控制语句、数组和字符串等等知识点。想要知道更多关于java基础知识的朋友,请阅读本专题下面的的有关文章,欢迎大家来php中文网学习。

1564

2023.10.24

JavaScript浏览器渲染机制与前端性能优化实践
JavaScript浏览器渲染机制与前端性能优化实践

本专题围绕 JavaScript 在浏览器中的执行与渲染机制展开,系统讲解 DOM 构建、CSSOM 解析、重排与重绘原理,以及关键渲染路径优化方法。内容涵盖事件循环机制、异步任务调度、资源加载优化、代码拆分与懒加载等性能优化策略。通过真实前端项目案例,帮助开发者理解浏览器底层工作原理,并掌握提升网页加载速度与交互体验的实用技巧。

59

2026.03.06

热门下载

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

精品课程

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

共94课时 | 11万人学习

C 教程
C 教程

共75课时 | 5.3万人学习

C++教程
C++教程

共115课时 | 21.2万人学习

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

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