用静态文本替换字段
当您希望将文档保存为静态副本时,通常需要替换字段。例如,作为电子邮件附件发送时。将 DATE
或 TIME
等字段转换为静态文本将使文档显示与发送时相同的日期。此外,在某些情况下,您可能需要从文档中删除条件 IF
字段,并将其替换为最新的文本结果。例如,将 IF
字段的结果转换为静态文本,这样当文档中的字段更新时,它将不再动态更改其值。
下图显示了 IF
字段如何存储在文档中:
- 文本被特殊字段节点包围 - FieldStart 和 FieldEnd
- FieldSeparator节点将字段内的文本分为字段代码和字段结果
- 字段代码定义字段的一般行为,而当使用 Microsoft Word 或 Aspose.Words 更新该字段时,字段结果保留最新结果
- 字段结果是存储在字段中并在查看时显示在文档中的内容
下面还可以使用 演示项目*“DocumentExplorer”*. 以分层形式查看该结构
无法用文本替换的字段
对于页眉或页脚中的某些字段,用静态文本替换字段无法正常工作。
例如,尝试将页眉或页脚中的 PAGE
字段转换为静态文本将导致所有页面上显示相同的值。这是因为页眉和页脚在多个页面中重复,并且当它们保留为字段时,会对其进行特殊处理,以便为每个页面显示正确的结果。
然而,在标头中,PAGE
字段可以很好地转换为静态文本。该文本运行将被视为该部分中的最后一页,这将导致标题中的任何 PAGE
字段显示所有页面的最后一页。
以下代码示例显示如何用最新结果替换该字段:
例子
转换特定文档部分中的某些字段类型
由于 ConvertFieldsToStaticText 方法接受两个参数 - CompositeNode 属性和 FieldType 枚举,因此可以将任何复合节点传递给此方法。这允许仅在文档的特定部分将字段转换为静态文本。
例如,您可以传递 Document 对象并将指定类型的字段从整个文档转换为静态文本,也可以传递某个部分的 Body 对象并仅转换在该正文中找到的字段。
传递给 ConvertFieldsToStaticText 方法的 FieldType 枚举指定应将哪种类型的字段转换为静态文本。文档中找到的任何其他字段类型将保持不变。
以下代码示例展示了如何在特定节点 - compositeNode 中选择特定类型 - targetFieldType 的字段,然后将其转换为静态文本:
以下代码示例演示如何将文档中的所有 IF
字段转换为静态文本:
以下代码示例演示如何将文档正文中的所有 PAGE
字段转换为静态文本:
以下代码示例显示如何将最后一段中的所有 IF
字段转换为静态文本: