0

0

OpenXML SDK怎么用 C#操作Word(docx)的XML

月夜之吻

月夜之吻

发布时间:2026-01-13 09:49:49

|

994人浏览过

|

来源于php中文网

原创

Open XML SDK 是微软官方 .NET 类库,用于直接读写 Office Open XML 文件(如 .docx),不依赖 Word 应用程序;通过强类型对象模型(如 Document、Paragraph)操作内容,自动处理 XML 序列化与包结构;需安装 DocumentFormat.OpenXml NuGet 包,创建文档须手动添加 MainDocumentPart 并初始化 Document 根元素;插入文本需按 Body→Paragraph→Run→Text 层级构建对象树后 Append;修改现有文档可遍历 Text 元素赋值;直触 XML 时须注意命名空间和流操作规范;每次操作后须调用 Close() 或使用 using 确保资源释放。

openxml sdk怎么用 c#操作word(docx)的xml

Open XML SDK 是微软提供的用于操作 Office Open XML 文件(如 .docx、.xlsx、.pptx)的官方 .NET 类库。它不依赖 Word 应用程序,而是直接读写底层 ZIP 封装内的 XML 内容,性能高、可控性强。用 C# 操作 Word 文档的 XML,本质是通过 SDK 提供的强类型对象模型(如 DocumentParagraphRun 等)来增删改查内容,SDK 自动处理底层 XML 序列化与包结构(如 document.xml、rels、styles.xml 等)。

安装 Open XML SDK 并创建基础文档

在项目中安装 NuGet 包:DocumentFormat.OpenXml(最新稳定版,如 3.0+)。注意:.NET 6/7/8 项目推荐使用该包;旧版 OpenXML SDK 2.5 已停止更新,且需额外安装运行时。

  • 新建空白 .docx:用 WordprocessingDocument.Create() 创建新文件,指定 WordprocessingDocumentType.Document
  • 必须手动添加主文档部件(MainDocumentPart),再通过 AddMainDocumentPart() 获取引用
  • 调用 MainDocumentPart.Document = new Document() 初始化根元素,否则后续操作会抛异常

向文档插入文本与段落

所有内容都封装在 BodyParagraphRunText 的层级中。SDK 不直接编辑原始 XML 字符串,而是构建对象树后保存。

  • 获取 Body:通过 mainPart.Document.Body ??= new Body() 确保存在
  • 新建段落:var para = new Paragraph(new Run(new Text("Hello, World!")))
  • 追加到文档:body.Append(para)(注意不是 AppendChild,这是常见误区)
  • 支持格式:可在 Run 中添加 RunProperties 设置字体、加粗、颜色等

读取并修改现有文档中的文本

打开已有 .docx 时用 WordprocessingDocument.Open(path, isEditable: true)。读取文本需遍历 ParagraphText 元素。

科大讯飞-AI虚拟主播
科大讯飞-AI虚拟主播

科大讯飞推出的移动互联网智能交互平台,为开发者免费提供:涵盖语音能力增强型SDK,一站式人机智能语音交互解决方案,专业全面的移动应用分析;

下载
  • 获取所有文本节点:doc.MainDocumentPart.Document.Body.Descendants()
  • 修改内容:textNode.Text = "New content"(直接赋值即可,SDK 会在 Save() 时同步)
  • 注意:不要直接修改 InnerText 或手动拼接 XML 字符串——这会破坏命名空间和结构,SDK 会忽略或报错
  • 若需定位特定段落(如含某关键词),可用 LINQ 配合 InnerTextGetText() 辅助方法

访问底层 XML 进行高级定制

虽然 SDK 推荐使用对象模型,但某些场景(如插入自定义 XML 部件、修改页眉页脚复杂结构、调试)需要直触 XML。

  • 获取原始 XML 字符串:mainPart.GetStream().ReadAllText()(仅用于查看,不可直接修改后写回)
  • 安全方式:用 mainPart.Document.Save(mainPart.GetStream()) 保存对象树;若需注入自定义 XML 片段,应通过 OuterXml 属性或 XmlDocument 加载后插入节点(需严格匹配命名空间)
  • 常用命名空间前缀:w:wordprocessingML)、r:(relationships)、mc:(markup compatibility)——SDK 对象已自动处理,手动操作 XML 时必须显式声明

不复杂但容易忽略:每次修改后必须调用 document.Close() 或使用 using 语句释放资源,否则文件可能被锁住或内容未写入磁盘。

相关专题

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

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

1873

2024.04.01

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

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

2085

2024.08.01

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

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

981

2024.11.28

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

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

254

2023.08.03

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

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

206

2023.09.04

java基础知识汇总
java基础知识汇总

java基础知识有Java的历史和特点、Java的开发环境、Java的基本数据类型、变量和常量、运算符和表达式、控制语句、数组和字符串等等知识点。想要知道更多关于java基础知识的朋友,请阅读本专题下面的的有关文章,欢迎大家来php中文网学习。

1463

2023.10.24

字符串介绍
字符串介绍

字符串是一种数据类型,它可以是任何文本,包括字母、数字、符号等。字符串可以由不同的字符组成,例如空格、标点符号、数字等。在编程中,字符串通常用引号括起来,如单引号、双引号或反引号。想了解更多字符串的相关内容,可以阅读本专题下面的文章。

617

2023.11.24

java读取文件转成字符串的方法
java读取文件转成字符串的方法

Java8引入了新的文件I/O API,使用java.nio.file.Files类读取文件内容更加方便。对于较旧版本的Java,可以使用java.io.FileReader和java.io.BufferedReader来读取文件。在这些方法中,你需要将文件路径替换为你的实际文件路径,并且可能需要处理可能的IOException异常。想了解更多java的相关内容,可以阅读本专题下面的文章。

548

2024.03.22

PHP 表单处理与文件上传安全实战
PHP 表单处理与文件上传安全实战

本专题聚焦 PHP 在表单处理与文件上传场景中的实战与安全问题,系统讲解表单数据获取与校验、XSS 与 CSRF 防护、文件类型与大小限制、上传目录安全配置、恶意文件识别以及常见安全漏洞的防范策略。通过贴近真实业务的案例,帮助学习者掌握 安全、规范地处理用户输入与文件上传的完整开发流程。

0

2026.01.13

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
HTML5/CSS3/JavaScript/ES6入门课程
HTML5/CSS3/JavaScript/ES6入门课程

共102课时 | 6.6万人学习

前端基础到实战(HTML5+CSS3+ES6+NPM)
前端基础到实战(HTML5+CSS3+ES6+NPM)

共162课时 | 18.7万人学习

第二十二期_前端开发
第二十二期_前端开发

共119课时 | 12.3万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号