讲师中心 微信公众号
AI工具推荐 视频效率加速

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

落明小哥_9408

落明小哥_9408

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

|

273人浏览过

|

来源于php中文网

原创

SaveOptions.None会删除格式性空白节点但保留显式字符串;真正保留缩进需加载时用LoadOptions.PreserveWhitespace并保存时用SaveOptions.DisableFormatting或Format。

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

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

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

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

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

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

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

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

C#
C#

"避开 C# 常见错误——空陷阱、异步陷阱、LINQ 陷阱及资源泄漏。"

下载
  • 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工具

更多
豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

SkildArt
SkildArt Hot

SkildArt是一款AI文本写作工具,一站式 AI 视觉创作平台。

讯飞绘文

讯飞绘文是一款由科大讯飞推出的一站式 AIGC 内容运营平台。

音述AI
音述AI Hot

一款AI音频处理工具,主要用于音述AI是一个以“用声音述说故事”为核心的 AI 音乐创作与声音分享社区,适合需要提升相关任务效率的用户。

蛙蛙写作

一款AI论文写作工具,主要用于超级AI智能写作助手,适合需要提升相关任务效率的用户。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

切问学术

切问学术是一款AI论文写作工具,复旦大学NLP团队推出的AI学术智能体。

火山引擎

火山引擎是一款面向企业的云计算与AI服务平台。

相关专题

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

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

1729

2023.07.31

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

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

1211

2024.06.27

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

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

4564

2024.04.01

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

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

5917

2024.08.01

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

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

2462

2024.11.28

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

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

1738

2023.08.03

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

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

2684

2023.09.04

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

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

6064

2023.10.24

OpenJDK JVM参数怎么调优
OpenJDK JVM参数怎么调优

Java应用运行缓慢,如何调整JVM参数?本专题介绍OpenJDK JVM性能调优的基本流程,涵盖性能指标确认、运行数据采集、内存配置和垃圾回收分析,帮助你先定位瓶颈,再通过对照测试验证效果,避免直接套用参数而影响应用稳定性。

80

2026.10.16

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
C++ Core Guidelines
C++ Core Guidelines

共0课时 | 0人学习

C++ Reference
C++ Reference

共0课时 | 0人学习

C++ 官方标准说明
C++ 官方标准说明

共0课时 | 0人学习

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

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn