C# 如何使用XmlWriter手动构建复杂的xml文档-C#.Net教程-PHP中文网

C# 如何使用XmlWriter手动构建复杂的xml文档

星降

发布： 2025-10-29 08:33:02

原创

232人浏览过

使用XmlWriter可高效生成大型XML文件。通过XmlWriter.Create()创建实例，配合XmlWriterSettings设置格式，逐层调用WriteStartElement、WriteElementString等方法构建包含命名空间、属性、嵌套结构的复杂XML，并确保正确关闭元素和使用using语句释放资源。

c# 如何使用xmlwriter手动构建复杂的xml文档

在C#中使用 XmlWriter 手动构建复杂的XML文档是一种高效且内存友好的方式，特别适用于生成大型XML文件或需要精确控制输出格式的场景。XmlWriter 提供了快速、只进（forward-only）的写入机制，不加载整个文档到内存，适合流式写入。

创建 XmlWriter 实例

使用 XmlWriter.Create() 方法可以创建一个 XmlWriter 对象。你可以传入文件路径、Stream 或 TextWriter，并通过 XmlWriterSettings 控制格式化行为。

示例如下：

夸克文档

夸克文档智能创作工具，支持AI写作/AIPPT/AI简历/AI搜索等

查看详情

var settings = new XmlWriterSettings
{
    Indent = true,
    IndentChars = "  ",
    NewLineChars = "\n",
    Encoding = Encoding.UTF8
};
<p>using (var writer = XmlWriter.Create("output.xml", settings))
{
// 开始写入 XML 内容
}</p>

登录后复制

逐步构建复杂结构

XmlWriter 支持逐层写入元素、属性、文本、注释等。以下是一个构建包含嵌套对象、属性和命名空间的复杂XML示例：

using (var writer = XmlWriter.Create("invoice.xml", settings))
{
    // 写入 XML 声明
    writer.WriteStartDocument();
<pre class='brush:php;toolbar:false;'>// 添加注释
writer.WriteComment("Generated invoice data");

// 写入根元素并声明命名空间
writer.WriteStartElement("Invoice");
writer.WriteAttributeString("xmlns", "inv", null, "http://example.com/invoice");
writer.WriteAttributeString("xmlns:xsi", null, "http://www.w3.org/2001/XMLSchema-instance");
writer.WriteAttributeString("xsi:schemaLocation", null,
    "http://example.com/invoice invoice.xsd");

// 写入头部信息
writer.WriteElementString("InvoiceNumber", "INV-2024-001");
writer.WriteElementString("IssueDate", DateTime.Today.ToString("yyyy-MM-dd"));

// 写入客户信息（嵌套元素）
writer.WriteStartElement("Customer");
writer.WriteAttributeString("type", "Retail");
writer.WriteElementString("Name", "张三");
writer.WriteElementString("Phone", "138-0000-0000");

writer.WriteStartElement("Address");
writer.WriteElementString("Street", "北京市朝阳区某街123号");
writer.WriteElementString("City", "北京");
writer.WriteElementString("Country", "中国");
writer.WriteEndElement(); // Address
writer.WriteEndElement(); // Customer

// 写入多个商品项
writer.WriteStartElement("Items");
var items = new[]
{
    new { Name = "笔记本电脑", Price = 8999.00, Qty = 1 },
    new { Name = "鼠标", Price = 199.00, Qty = 2 }
};

foreach (var item in items)
{
    writer.WriteStartElement("Item");
    writer.WriteAttributeString("id", Guid.NewGuid().ToString("N").Substring(0, 8));

    writer.WriteElementString("ProductName", item.Name);
    writer.WriteElementString("UnitPrice", item.Price.ToString("F2"));
    writer.WriteElementString("Quantity", item.Qty.ToString());
    writer.WriteElementString("Total", (item.Price * item.Qty).ToString("F2"));

    writer.WriteEndElement(); // Item
}
writer.WriteEndElement(); // Items

// 写入总计
writer.WriteStartElement("Totals");
writer.WriteElementString("Subtotal", "9397.00");
writer.WriteElementString("Tax", "1127.64");
writer.WriteElementString("GrandTotal", "10524.64");
writer.WriteEndElement(); // Totals

// 关闭根元素
writer.WriteEndElement();

// 写入结束文档（可选，Dispose 时会自动处理）
writer.WriteEndDocument();

登录后复制

}

关键技巧与注意事项

注意元素嵌套层级：每次 WriteStartElement 必须有对应的 WriteEndElement，否则会抛出异常或生成无效XML。
使用 using 语句：确保 XmlWriter 正确关闭并刷新缓冲区。
避免手动拼接字符串：所有内容应通过 Write* 方法写入，防止特殊字符（如 <, >, &）导致格式错误。
支持命名空间管理：使用前缀和命名空间 URI 保持文档规范性，尤其在对接标准协议时很重要。
性能优化：对于超大文件，可设置 settings.Async = true 并配合异步写入方法（需手动启用）。