讲师中心 微信公众号

工具推荐

视频效率加速
Seko
Seko

AI短剧一键生成成片

updream

一键生成高质量推广成片

立刻MV
立刻MV

低成本歌曲 MV、视频生成

Laper
Laper

剧本策划到成片协作

C# XmlWriter WriteAttributeString 写入属性键值对

老丽吖_5463

老丽吖_5463

发布时间:2026-02-28 00:35:13

|

1021人浏览过

|

来源于php中文网

原创

WriteAttributeString自动转义XML五种预定义实体,其他字符原样写入;非法字符(如\0)在.NET 6+抛ArgumentException;命名空间需用特定重载;不可混用WriteStartAttribute;null/空字符串均输出attr=""。

c# xmlwriter writeattributestring 写入属性键值对

WriteAttributeString 会自动转义特殊字符吗

会,但只转义 XML 标准定义的五个预定义实体:&、、<code>>、"、'。其他 Unicode 字符(比如中文、emoji、控制字符)原样写入,不编码也不报错。

常见错误现象:WriteAttributeString("name", "a & b <test>")</test> 输出为 name="a & b <test>"</test>,这是预期行为;但如果传入 \0 或 \x01,.NET 6+ 会抛 ArgumentException:“Invalid character in the given encoding”,因为 XML 规范禁止这些字符。

  • 若需支持任意二进制数据,先 Base64 编码再写入,别指望 WriteAttributeString 帮你处理
  • 不要手动提前转义——比如把 & 换成 & 再传进去,否则会被双重转义成 &
  • .NET Core 3.1+ 对非法字符检查更严格,旧项目升级后可能突然报错

写命名空间属性要用 WriteAttributeString 吗

不能直接用。命名空间声明(如 xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance")本质是特殊属性,但 WriteAttributeString 不识别 xmlns 前缀语义,它只会当成普通属性名写死,无法触发命名空间绑定逻辑。

正确做法是用 WriteAttributeString 的重载或配合 WriteStartElement:

  • 写默认命名空间:用 WriteAttributeString("xmlns", "http://my.ns")
  • 写带前缀的命名空间:用 WriteAttributeString("xmlns", "xsi", null, "http://www.w3.org/2001/XMLSchema-instance")
  • 如果已调用 WriteStartElement("root", "http://my.ns"),后续元素自动继承该命名空间,无需重复声明

WriteAttributeString 和 WriteStartAttribute 配合使用行不行

不行,会抛 InvalidOperationException:“WriteStartAttribute cannot be called when the writer is in a state where an attribute can be written.”

C#
C#

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

下载

WriteAttributeString 是原子操作,内部已封装了开始、写内容、结束三步;而 WriteStartAttribute 是低阶 API,必须配对 WriteString + WriteEndAttribute。混用会破坏写入器状态机。

  • 99% 场景只用 WriteAttributeString,它简洁且安全
  • 只有需要分段写入属性值(比如流式拼接、动态计算中间值)才考虑 WriteStartAttribute,但极少见
  • 一旦调用 WriteStartAttribute,就不能在同级再调用任何 WriteAttributeString

空字符串或 null 当作属性值会发生什么

null 会被当作空字符串处理,写入结果是 attr="";空字符串本身也输出为 attr=""。两者效果一致,不会跳过该属性,也不会报错。

但要注意:XML Schema 中若该属性声明为 use="required",空值仍算“存在”,只是内容为空——校验是否通过取决于 schema 定义,不是 XmlWriter 的责任。

  • 别用 if (val != null) writer.WriteAttributeString(...) 来“避免空属性”,这逻辑和业务意图往往不符
  • 如果协议明确要求省略空属性,得自己判断:if (!string.IsNullOrEmpty(val)) writer.WriteAttributeString(...)
  • 写入 val = " "(空格)会被保留,不会 trim,XML 层不负责空白归一化

最常被忽略的是字符合法性边界——不是所有能显示的字符串都合法,XmlWriter 在 close 时才做最终验证,出错时堆栈不指向 WriteAttributeString 调用点,而是指向 Close() 或 Dispose()。调试时得倒查最近写的属性值。

热门AI工具

更多
Loomy
Loomy Hot

一款AI工具,主要用于科大讯飞发布的桌面级 AI 助理,比 OpenClaw 更易用、更安全!,适合需要提升相关任务效率的用户。

DeepSeek

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

函子Zion

一款支持AI搭建、可视化编辑和多端发布的全栈无代码开发平台。

Lovart
Lovart Hot

一款面向视觉设计创作的AI设计平台,可通过智能体和画布工作流辅助制作海报、Logo、网页、PPT及其他视觉内容。

WorkBuddy

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

UP简历
UP简历 Hot

一款AI办公效率工具,主要用于基于AI技术的免费在线简历制作工具,适合需要提升相关任务效率的用户。

豆包大模型

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

花生AI
花生AI Hot

一款AI视频创作工具,主要用于B站推出的AI视频创作工具,适合需要提升相关任务效率的用户。

UpDream
UpDream Hot

一款AI视频创作工具,主要用于哔哩哔哩推出的自研AI视频创作工具,适合需要提升相关任务效率的用户。

相关专题

更多
string转int
string转int

在编程中,我们经常会遇到需要将字符串(str)转换为整数(int)的情况。这可能是因为我们需要对字符串进行数值计算,或者需要将用户输入的字符串转换为整数进行处理。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

7599

2023.08.02

c语言中null和NULL的区别
c语言中null和NULL的区别

c语言中null和NULL的区别是:null是C语言中的一个宏定义,通常用来表示一个空指针,可以用于初始化指针变量,或者在条件语句中判断指针是否为空;NULL是C语言中的一个预定义常量,通常用来表示一个空值,用于表示一个空的指针、空的指针数组或者空的结构体指针。

569

2023.09.22

java中null的用法
java中null的用法

在Java中,null表示一个引用类型的变量不指向任何对象。可以将null赋值给任何引用类型的变量,包括类、接口、数组、字符串等。想了解更多null的相关内容,可以阅读本专题下面的文章。

1698

2024.03.01

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

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

5184

2024.04.01

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

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

6737

2024.08.01

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

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

2642

2024.11.28

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

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

1938

2023.08.03

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

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

3204

2023.09.04

Go-Zero API开发使用教程
Go-Zero API开发使用教程

本专题聚焦Go-Zero的API开发,拆解.api描述文件的语法结构、路由与分组定义、参数绑定与校验规则,说明统一响应体、JWT鉴权、跨域与接口文档生成的落地方式,并给出网关聚合与接口测试的实践建议。

100

2026.11.12

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
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