C# XmlWriter WriteElementString 写入包含文本的元素

writeelementstring 仅安全写入带文本内容的闭合元素，自动转义特殊字符以确保xml良构；需嵌入html/xml片段、添加属性或处理控制字符时，须改用writeraw、writestartelement等组合api。

WriteElementString 会自动转义特殊字符，别指望它直接写入 HTML 或 XML 片段

如果你传给 WriteElementString 一个含 、<code>&、" 的字符串，它不会原样输出，而是自动转义成 <、&、"。这是正确行为，不是 bug —— 它保证生成的 XML 是良构的。

常见错误现象：
想写入 <b>bold</b>，结果得到 <b>bold</b>，浏览器里显示为纯文本。

• 若真要嵌入已格式化的 XML/HTML 片段，必须用 WriteRaw 或 WriteCData，但得自己确保内容安全且合法
• WriteElementString("content", "<b>hello</b>") → 错误预期；应改用 WriteStartElement("content"); WriteRaw("<b>hello</b>"); WriteEndElement();
• 注意：使用 WriteRaw 绕过转义时，如果内容来自用户输入，可能引入 XML 注入或解析失败

WriteElementString 不支持写空元素带属性，属性必须用 WriteStart/EndElement 拆开

WriteElementString 只接受元素名和内容值两个核心参数，没法传属性。想写 <item id="123">text</item>？它做不到。

使用场景：导出带 ID、type、timestamp 等元数据的简单记录。

AI封面生成器

专业的AI封面生成工具，支持小红书、公众号、小说、红包、视频封面等多种类型，一键生成高质量封面图片。

下载

• 错误写法：WriteElementString("item", "text") → 输出 <item>text</item>，没属性
• 正确写法：WriteStartElement("item"); WriteAttributeString("id", "123"); WriteString("text"); WriteEndElement();
• 漏掉 WriteEndElement() 会导致 XML 截断或解析失败，尤其在循环中容易忘记配对

WriteString 和 WriteElementString 的嵌套层级逻辑容易混淆

WriteElementString 是“原子操作”：它内部自动处理开始标签、内容、结束标签。而 WriteString 只写文本内容，必须处在已打开的元素内，否则抛 InvalidOperationException：“Token StartElement in state Content would result in an invalid XML document”。

性能影响：频繁混用两者而不注意状态，会让代码逻辑变脆，调试时难定位是哪一层没关好。

• 以下会报错：WriteString("abc") 在根节点外直接调用
• 以下合法：WriteStartElement("root"); WriteString("abc"); WriteEndElement();
• 以下也合法（WriteElementString 自己管理）：WriteStartElement("root"); WriteElementString("child", "def"); WriteEndElement();
• 别在 WriteElementString 后紧跟 WriteString，除非你刚用 WriteStartElement 打开了新容器

中文、emoji 或控制字符写入失败？检查 XmlWriterSettings 的 Encoding 和 CheckCharacters

默认 XmlWriter.Create 使用 UTF-8，但若你手动指定了 Encoding.ASCII，中文就会被替换成问号或直接抛异常；更隐蔽的是 CheckCharacters = true（默认开启），它会拒绝 Unicode 控制字符（如 \u0000–\u0008, \u000B–\u000C, \u000E–\u001F），哪怕它们在 .NET 字符串里合法。

错误信息示例："The character '' is an invalid XML character."

• 写入前先清理：用 Regex.Replace(input, @"[\x00-\x08\x0B\x0C\x0E-\x1F]", "") 剔除非法控制符
• 创建 writer 时显式配置：new XmlWriterSettings { Encoding = Encoding.UTF8, CheckCharacters = false } —— 仅当你确认源数据干净时才关 CheckCharacters
• 别依赖 Console 输出判断内容是否正常：终端可能截断或乱码，用 File.ReadAllText("out.xml", Encoding.UTF8) 验证原始字节