通过

将 Open XML 包部件的内容复制到其他包中的文档部件

  • 项目

本主题演示如何使用 Open XML SDK for Office 中的类以编程方式将 Open XML Wordprocessing 文档部件的内容复制到其他字处理文档中的文档部件。

包和文档部件

Open XML 文档存储为包，其格式由 ISO/IEC 29500 定义。 包可以具有多个彼此之间存在关系的部件。 部件之间的关系控制文档的类别。 如果文档的包关系项包含与主文档部件的关系，可将文档定义为字处理文档。 如果文档的包关系项包含与演示文稿部件的关系，可将文档定义为演示文稿文档。 如果文档的包关系项包含与工作簿部件的关系，可将文档定义为电子表格文档。 在本操作方法主题中，您将使用字处理文档包。

获取 WordprocessingDocument 对象

若要打开现有文档，请实例化 类， WordprocessingDocument 如以下两 using 条语句所示。 在同一语句中，使用 方法打开具有指定文件名 Open 的字处理文件，并使用布尔参数。 对于将 参数 false 设置为 以将其打开进行只读访问的源文件。 对于目标文件，将 参数 true 设置为 以启用编辑文档。

using (WordprocessingDocument wordDoc1 = WordprocessingDocument.Open(fromDocument1, false))
using (WordprocessingDocument wordDoc2 = WordprocessingDocument.Open(toDocument2, true))

在 v3.0.0+ 中， Close() 已删除 方法，转而依赖于 using 语句。 它确保在 Dispose() 到达右大括号时自动调用 方法。 using 语句后面的块为 using 语句中创建或指定的对象设定范围。 WordprocessingDocument由于 Open XML SDK 中的 类会自动保存并关闭对象作为其IDisposable实现的一using部分，并且由于Dispose()在退出块时会自动调用，因此无需显式调用 Save() 或 Dispose() ，只要使用 语句。

WordProcessingML 文档的结构

文档的基本文档结构WordProcessingML由 和 body 元素组成document，后跟一个或多个块级元素（例如 p表示段落）。 段落包含一个或多个 r 元素。 r代表 run，它是具有一组通用属性（如格式设置）的文本区域。 运行包含一个或多个 t 元素。 元素 t 包含文本范围。 下面的代码示例演示 WordprocessingML 包含文本“示例文本”的文档的标记。

    <w:document xmlns:w="http://schemas.openxmlformats.org/wordprocessingml/2006/main">
      <w:body>
        <w:p>
          <w:r>
            <w:t>Example text.</w:t>
          </w:r>
        </w:p>
      </w:body>
    </w:document>

使用 Open XML SDK，可以使用与元素对应的 WordprocessingML 强类型类创建文档结构和内容。 可以在 命名空间中找到 DocumentFormat.OpenXml.Wordprocessing 这些类。 下表列出了对应于 、、body、 rp和 t 元素的类的document类名。

WordprocessingML 元素 Open XML SDK 类 说明
<document/> Document 主文档部件的根元素。
<body/> Body 块级结构（如段落、表格、批注和 ISO/IEC 29500 规范中指定的其他项）的容器。
<p/> Paragraph 段落。
<r/> Run 一段连续文本。
<t/> Text 文本范围。

有关 WordprocessingML 文档的各个部分和元素的整体结构的详细信息，请参阅 WordprocessingML 文档的结构。

主题部件

主题部件包含有关文档的颜色、字体和格式的信息。 它在 ISO/IEC 29500（该链接可能指向英文页面） 规范中的定义如下。

此部件类型的实例包含有关文档主题的信息，即配色方案、字体方案和格式方案（后者也称为效果）的组合。 对于 WordprocessingML 文档，主题的选择会影响标题的颜色和样式以及其他事项。 对于 SpreadsheetML 文档，主题的选择会影响单元格内容和图表的颜色和样式以及其他事项。 对于 PresentationML 文档，主题的选择会通过关联的母版影响幻灯片、讲义和备注的格式以及其他事项。

一个 WordprocessingML 或 SpreadsheetML 包应包含零个或一个主题部件，该部件应为主文档 (§11.3.10) 或工作簿 (§12.3.23) 部件中的一个隐式关系的目标。 一个 PresentationML 包通过隐式关系对每个讲义母版 (§13.3.3)、备注母版 (§13.3.4)、幻灯片母版 (§13.3.10) 或演示文稿 (§13.3.6) 部件包含零个或一个主题部件。

示例：以下 WordprocessingML 主文档部件关系项包含与主题部件的关系，该部件存储在 ZIP 项目主题/theme1.xml 中：

    <Relationships xmlns="…">
       <Relationship Id="rId4"
          Type="https://…/theme" Target="theme/theme1.xml"/>
    </Relationships>

© ISO/IEC 29500：2016

示例代码的工作方式

若要将 Open XML 包中文档部件的内容复制到其他包中的文档部件，会将每个字处理文档的完整路径作为参数 CopyThemeContent 传入 方法。 然后，代码将这两个文档作为 WordprocessingDocument 对象打开，并创建引用 ThemePart 每个包中的部分的变量。

static void CopyThemeContent(string fromDocument1, string toDocument2)
{
    using (WordprocessingDocument wordDoc1 = WordprocessingDocument.Open(fromDocument1, false))
    using (WordprocessingDocument wordDoc2 = WordprocessingDocument.Open(toDocument2, true))
    {
        ThemePart? themePart1 = wordDoc1?.MainDocumentPart?.ThemePart;
        ThemePart? themePart2 = wordDoc2?.MainDocumentPart?.ThemePart;

然后，代码使用 对象读取源 ThemePart 部件的内容， StreamReader 并使用 写入目标 ThemePart 部件 StreamWriter。

using (StreamReader streamReader = new StreamReader(themePart1.GetStream()))
using (StreamWriter streamWriter = new StreamWriter(themePart2.GetStream(FileMode.Create)))
{
    streamWriter.Write(streamReader.ReadToEnd());
}

示例代码

下面的代码将某个 Open XML 包中的一个文档部件的内容复制到另一包中的文档部件。 若要调用 CopyThemeContent 方法，可以使用以下示例，该示例将主题部分从位于 args[0] 的包复制到 位于 的包中 args[1]。

string fromDocument1 = args[0];
string toDocument2 = args[1];

CopyThemeContent(fromDocument1, toDocument2);

重要

运行程序之前，请确保源文档已设置主题部件。 若要向文档添加主题，请在Microsoft Word中将其打开，单击“设计”选项卡，然后单击“主题”，然后选择其中一个可用主题。

运行程序后，可以检查文件以查看更改的主题。

以下是使用 C# 和 Visual Basic 编写的完整示例代码。

static void CopyThemeContent(string fromDocument1, string toDocument2)
{
    using (WordprocessingDocument wordDoc1 = WordprocessingDocument.Open(fromDocument1, false))
    using (WordprocessingDocument wordDoc2 = WordprocessingDocument.Open(toDocument2, true))
    {
        ThemePart? themePart1 = wordDoc1?.MainDocumentPart?.ThemePart;
        ThemePart? themePart2 = wordDoc2?.MainDocumentPart?.ThemePart;

        // If the theme parts are null, then there is nothing to copy.
        if (themePart1 is null || themePart2 is null)
        {
            return;
        }
        using (StreamReader streamReader = new StreamReader(themePart1.GetStream()))
        using (StreamWriter streamWriter = new StreamWriter(themePart2.GetStream(FileMode.Create)))
        {
            streamWriter.Write(streamReader.ReadToEnd());
        }
    }
}

另请参阅