openxml

学习C#调用OpenXml操作word文档的基本用法（31：学习图形类-1）文本运行类Run的子类型Drawing用于保存word文档中的图片、图表、形状等图形对象，命名空间为DocumentFormat.OpenXml.Wordprocessing，对应document.xml文件内的元素如下图所示。本文学习使用Drawing类将图片保存到Word文档的基本用法。图形类Drawing的类继承链为OpenXmlElement -> OpenXmlCompositeElement-> Drawing，其主要属性包括以下两个： 1）Anchor属性：浮动式布局，精确控制图形

学习C#调用OpenXml操作word文档的基本用法（30：学习日期相关类）文本运行类Run的子类型DayShort、DayLong、MonthShort、MonthLong、YearShort及YearLong用于向文本中插入年月日等信息，命名空间为DocumentFormat.OpenXml. Wordprocessing，对应document.xml文件内的元素如下图所示：上述六种日期类型继承自EmptyType，不包含任何用于控制格式的属性，其显示格式（如日期的长短格式）完全固定。六种日期类型的说明如下表所示：

学习C#调用OpenXml操作word文档的基本用法（28：学习文本类）文本类Text是openxml中用于保存纯文本内容的核心类，命名空间为DocumentFormat. OpenXml.Wordprocessing，对应document.xml文件内的<w:t>元素，负责保存word文档里真正可读、可编辑的文字信息。在openxml的wrod文档结构里，文本不能直接放在段落（Paragraph）下，必须按照段落类(Paragraph)、文本运行类(Run)、文本类(Text)的层级关系创建对象，Text对象保存文本内容，文本格式放在文本运行类中，而段落格式在放在段落

学习C#调用OpenXml操作word文档的基本用法（29：学习中断类）中断类Break是openxml中用于手动插入换行符、分页符或分栏符的核心类，命名空间为DocumentFormat.OpenXml.Wordprocessing，对应document.xml文件内的<w:br>元素，负责精细控制文档布局。中断类用于在文本运行类（Run）的当前位置放置中断，中断是一种特殊字符，用于替代基于文档内容的正常布局执行的常规换行，插入中断字符后会重新启动文本的位置，具体位置由中断类实例的类型和清除属性值确定。中断类Break的类继承链为OpenXmlElement -

学习C#调用OpenXml操作word文档的基本用法（27：学习文本运行类-续）上一篇文章中介绍的文本运行类Run，其中的RunProperties属性设置文本格式及效果，其类型为RunProperties，包括TextOutlineEffect、Reflection、Glow等效果设置属性，本文进一步学习这些属性的类型说明： 1）Glow属性：设置文字的发光效果，对应word文档中字体设置->文字效果中的发光设置，类型为Glow，主要属性如下表所示：

学习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格式的图片作为文档缩略图。下面示例代码将七龙珠图片添加为缩略图，运行效果如下图所示：