XmlDeclaration 是用于创建 XML 声明行的类，必须作为 XmlDocument 的第一个子节点添加；创建需调用 CreateXmlDeclaration 并用 AppendChild 首先插入，参数包括 version（如"1.0"）、encoding（如"utf-8"）和 standalone（如"yes"或 null）。
XmlDeclaration 是 C# 中 System.Xml 命名空间下的一个类，专门用来创建 XML 文档最开头的声明行，也就是形如 的那一行。它本身不是元素节点，而是文档级元信息，必须作为 XmlDocument 的第一个子节点添加，否则生成的 XML 文件可能不符合规范，部分解析器会报错或警告。
怎么创建并添加 XmlDeclaration
创建声明需要三步：调用 CreateXmlDeclaration 方法生成对象，再用 AppendChild 添加到文档根部。注意：必须在添加任何其他节点（比如根元素）之前完成这一步，否则声明会被插入到中间位置，XML 就不合法了。
-
version：几乎固定写"1.0"，这是当前唯一广泛支持的版本 -
encoding：指定文本编码，常用"utf-8"（推荐）或"gb2312"等；要和后续保存/读取时的编码一致 -
standalone：可为"yes"（默认无外部 DTD）、"no"（依赖外部定义），也可传null（省略该属性）
典型代码示例
下面是最简可用的写法：
XmlDocument doc = new XmlDocument();XmlDeclaration decl = doc.CreateXmlDeclaration("1.0", "utf-8", null);
doc.AppendChild(decl); // 必须最先加
XmlElement root = doc.CreateElement("config");
doc.AppendChild(root);
doc.Save("config.xml");
常见错误和注意事项
- 重复添加：一个
XmlDocument只能有一个声明，多次AppendChild同一声明或多个声明会抛异常 - 顺序错误：如果先加了根元素再加声明，生成的 XML 会变成“根元素在前、声明在后”，这种格式非法
- 加载已有文件时不需要手动创建：用
doc.Load("xxx.xml")读取时，声明已自动解析并存在doc.FirstChild中，可直接访问或修改 - 编码不匹配：声明里写
"utf-8"，但保存时用Encoding.GetEncoding("gbk")，会导致乱码——保存时应使用与声明一致的编码，或让Save()自动按声明处理（默认行为）
如何读取或修改已有声明
从已加载的文档中获取声明：
HTShop网上购物系统
下载
HTShop网上购物系统由恒天网络科技有限公司根据国际先进技术和国内商务特点自主版权开发的一款具有强大功能的B2C电子商务网上购物平台。HTShop以国际上通用流行的B/S(浏览器/服务器)模式进行设计，采用微软公司的ASP.NET（C#）技术构建而成。 2007-11-10 HTShop CS 通用标准版 v1.1.11.10 更新内容自由更换模版功能开放 修改了购买多款商品，会员中心订单只显示
if (existingDecl != null)
{
Console.WriteLine($"Version: {existingDecl.Version}");
Console.WriteLine($"Encoding: {existingDecl.Encoding}");
}
如需修改，不能直接改属性，得新建一个声明替换：
XmlDeclaration newDecl = doc.CreateXmlDeclaration("1.0", "utf-8", "yes");doc.ReplaceChild(newDecl, existingDecl);
不复杂但容易忽略
