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 等元数据的简单记录。
- 错误写法：
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)验证原始字节
WriteElementString 当万能文本写入函数用，忘了它只干一件事：安全地写一个带文本内容的闭合元素。其他需求，得切回基础 API 组合。 
