openxml

学习C#调用OpenXml操作word文档的基本用法（24：学习文档根元素类）OpenXML中，WordprocessingDocument类代表整个word文档，MainDocumentPart类代表word文档的主文档部分，对应document.xml文件，而Document类则是文档根元素类，对应document.xml文件的根节点标签，是文档内容的实际容器。这三个类的关系如下图所示（示意图来自DeepSeek）。 Document类主要包括以下属性： 1）Body属性：保存文档主体内容，类型为Body，对应 document.xml文件内的<w:body> 元素，包

学习C#调用OpenXml操作word文档的基本用法（26：学习文本运行类）文本运行类Run是openxml中用于表示文本运行的核心类，命名空间为DocumentFormat. OpenXml.Wordprocessing，对应document.xml文件内的<w:r>元素，是段落内具有相同字符格式的最小文本单元，可以包含实际文本、换行符、图片、符号等内联内容。Run类支持添加下图所示的几十种子类型。 Run类的主要属性如下表所示：

学习C#调用OpenXml操作word文档的基本用法（25：学习文档段落类）Openxml中Body类是文档根元素类Document的重要属性类，包含文档所有正文内容（段落、表格、图片等），该类型支持添加下图所示的几十种子类型。本文学习其中的Paragraph类的主要属性。 Paragraph类，命名空间为DocumentFormat.OpenXml.Wordprocessing，对应document.xml文件内的<w:p>元素，是文档内容的基本块级单元，几乎所有的文本、图片、表格等都需要放在段落中。Paragraph类型支持添加下图所示的几十种子类型： Paragra

学习C#调用OpenXml操作word文档的基本用法（23：学习术语表管理类）OpenXml中使用GlossaryDocumentPart类集中管理Word文档中所有的文档构建基块内容，适合用来存储合同中的可选条款、信函中的标准段落、公司信头或签名等各类需要重复使用的内容。采用解压缩软件打开Word模板文档（word文档中没有找到在哪里），其内的word\glossary文件夹中的document.xml文件保存通过程序插入的基块内容，如下图所示。 MainDocumentPart类的GlossaryDocumentPart属性保存基块信息集合，其类型为GlossaryDocu

学习C#调用OpenXml操作word文档的基本用法（21：学习嵌入对象类）OpenXml中使用EmbeddedObjectPart类处理Word文档内嵌入的OLE对象，MainDocumentPart类的EmbeddedObjectParts属性保存所有的OLE对象。以下图为例，向上一篇文章中的word文档中粘贴mp3文件和xml文件，采用解压缩软件打开Word文档，其内的embeddings文件夹中圈红处保存后续插入的两个文件的OLE对象数据，而media文件夹内圈红处则保存每个OLE对象在word文档中的显示图标。 MainDocumentPart类的EmbeddedO

学习C#调用OpenXml操作word文档的基本用法（20：学习嵌入文件类）OpenXml中使用EmbeddedPackagePart类处理Word文档内嵌入的完整文件（大模型介绍说主要处理Office文件，但没有在其它学习文档或微软文档中找到相关说明），MainDocumentPart类的EmbeddedPackageParts属性保存所有的嵌入文件。以下图为例，向word文档中粘贴visio图形及另一个word文件，采用解压缩软件打开Word文档，其内的embeddings文件夹中保存嵌入文件的原始内容，而media文件夹内则保存每个嵌入office文件在word文档中的显示

学习C#调用OpenXml操作word文档的基本用法（19：学习文档页脚类）OpenXml中使用FooterPart类保存Word文档内所有页脚信息，为文档中各节使用页脚提供引用目标。采用解压缩软件打开Word文档，其内的word文件夹中保存页脚文件，每个页脚都对应独立的footer.xml文件，然后在word文件夹的document.xml文件内引用页脚信息，如下图所示。

学习C#调用OpenXml操作word文档的基本用法（18：学习文档页眉类）OpenXml中使用HeaderPart类保存Word文档内所有页眉信息，为文档中各节使用页眉提供引用目标。采用解压缩软件打开Word文档，其内的word文件夹中保存页眉文件，每个页眉都对应独立的header.xml文件，然后在word文件夹的document.xml文件内引用页眉信息，如下图所示。

学习C#调用OpenXml操作word文档的基本用法（17：学习文档图片类）OpenXml中使用ImagePart类保存Word文档内所有图片的二进制数据，为文档中的图片元素提供引用目标。采用解压缩软件打开Word文档，其内的word\media文件夹中保存图片文件，然后在word文件夹的document.xml文件内引用图片信息，如下图所示。 MainDocumentPart类的ImageParts属性保存图片集合，其类型为IEnumerable<ImagePart>，ImagePart类存储单个图片对象，命名空间为DocumentFormat.OpenXml.Packag

学习C#调用OpenXml操作word文档的基本用法（16：学习文档脚注类）OpenXml中使用FootnotesPart类保存Word文档内所有脚注的定义和文本。采用解压缩软件打开Word文档，其内的word文件夹中有独立的footnotes.xml文件，用于保存文档中使用的脚注信息，如下图所示。 FootnotesPart类的Footnotes属性保存脚注集合，其命名空间及类型为DocumentFormat. OpenXml.Wordprocessing.Footnotes，通过调用Footnotes.Elements函数获取DocumentFormat. OpenXml

学习C#调用OpenXml操作word文档的基本用法（15：学习文档主题类）OpenXml中使用ThemePart类保存Word文档的主题，存储定义文档整体视觉风格（颜色、字体、效果）的XML数据。采用解压缩软件打开Word文档，其内的word\theme文件夹中有独立的theme1.xml文件，用于保存文档中使用的主题信息，如下图所示，其中clrScheme部分定义颜色主题，fontScheme部分定义字体主题，fmtScheme部分定义定义形状、图表等元素的填充、线条、特效等格式主题： ThemePart类的Theme属性保存主题集合，其命名空间及类型为DocumentF

学习C#调用OpenXml操作word文档的基本用法（14：学习文档编号定义类）OpenXml中使用NumberingDefinitionsPart类保存Word文档的列表和编号定义，以便在正文中引用，当在Word文档中创建项目符号列表、编号列表或多级列表时，其格式和规则就存储在该类中。采用解压缩软件打开Word文档，其内的word文件夹中有独立的numbering.xml文件，用于保存文档中使用的编号信息，如下图所示： NumberingDefinitionsPart类的Numbering属性保存编号定义，主要包括抽象编号定义 (AbstractNum) 和编号实例定义 (Nu

学习C#调用OpenXml操作word文档的基本用法（13：学习文档设置类）OpenXml中使用DocumentSettingsPart类保存Word文档的文档级设置，例如文档保护、字段更新行为等信息。采用解压缩软件打开Word文档，其内的word文件夹中有独立的settings.xml文件，用于保存文档设置信息。 1）WriteProtection属性：用于文档的写入保护设置。写入保护是指无法编辑文档内容的模式，并且不能使用相同的文件名重新保存文档。类型为WriteProtection，其主要属性如下表所示：

学习C#调用OpenXml操作word文档的基本用法（12：读取文档字体表）OpenXml中使用FontTablePart类保存Word文档字体表，存储和管理Word文档中使用的字体信息。采用解压缩软件打开Word文档，其内的word文件夹中有独立的fontTable.xml文件，用于保存文档中使用的字体信息，如下图所示： FontTablePart类的Fonts属性保存字体集合，其命名空间及类型为DocumentFormat.OpenXml. Wordprocessing.Fonts，通过调用fonts.Elements函数获取DocumentFormat.OpenXml.

学习C#调用OpenXml操作word文档的基本用法（11：操作文档缩略图）Openxml中WordprocessingDocument类的ThumbnailPart属性用于保存文档缩略图，其类型为ThumbnailPart，支持添加和读取缩略图。通常Word文档没有缩略图。在文件夹中以平铺、内容或各类尺寸图标形式查看Word文档时，显示的是Word软件的默认图标。ThumbnailPart类支持调用FeedData函数添加Jpg、Emf、Wmf格式的图片作为文档缩略图。下面示例代码将七龙珠图片添加为缩略图，运行效果如下图所示：

学习C#调用OpenXml操作word文档的基本用法（10：读取其它文档属性）上一篇文章中介绍的CoreFilePropertiesPart类保存Word文档的核心属性，除此之外，ExtendedFilePropertiesPart类保存Word文档的扩展属性，CustomFilePropertiesPart类保存自定义属性，本文学习后面2种类型的数据读取方式。

学习C#调用OpenXml操作word文档的基本用法（9：读取文档基本属性）WordprocessingDocument类的CoreFilePropertiesPart属性保存文档基本属性，CoreFilePropertiesPart.Features属性集合中保存各类特性实例对象，其中IPackageFeature特性对应的是文档基本属性对象实例。使用DocumentFormat.OpenXml.Packaging.IPackageProperties接口对应的实现类保存文档基本属性，该接口中的属性说明如下表所示：

学习C#调用OpenXml操作word文档的基本用法（7：Style类分析-5）OpenXml的Style类中StyleTableProperties属性类型为StyleTableProperties，用于定义整个表格的样式，而StyleTableCellProperties属性类型为StyleTableCellProperties，用于定义表格单元格样式。本文学习StyleTableProperties类的主要属性。 1）TableStyleRowBandSize属性：用于设置表格行区段的行数，也即表格样式中间隔行带状条纹的行数以创建斑马条纹效果，类型为TableStyleRo

学习C#调用OpenXml操作word文档的基本用法（5：Style类分析-3）OpenXML中的StyleParagraphProperties类用于定义段落样式的格式属性，例如对齐、缩进和间距等，它与ParagraphProperties类的主要区别在于作用范围，前者用于样式定义，而后者用于具体段落。 1）KeepNext属性：用于设置当前段落与其下一个段落保持在同一页，其效果等同于word文档中段落设置的换行和分页选项卡下的与下段同页复选框，类型为KeepNext，布尔值类型。 2）KeepLines属性：用于设置段落的所有行都保持在同一页，其效果等同于word文档中段

学习C#调用OpenXml操作word文档的基本用法（3：Style类分析-1）Openxml中的Style类用于定义Word文档中的各种样式，主要针对段落、字符、表格等数据类型，其主要属性如下表所示：