插入字段
有几种不同的方法可以将字段插入到文档中:
在本文中,我们将更详细地了解每种方式,并分析如何使用这些选项插入某些字段。
使用 DocumentBuilder 将字段插入文档
在 Aspose.Words 中,InsertField 方法用于将新字段插入到文档中。第一个参数接受要插入的字段的完整字段代码。第二个参数是可选的,允许手动设置字段的字段结果。如果未提供此字段,则该字段会自动更新。您可以将 null 或empty 传递给此参数以插入具有空字段值的字段。如果您不确定特定的字段代码语法,请先在 Microsoft Word 中创建字段,然后切换以查看其字段代码。
以下代码示例演示如何使用 DocumentBuilder 将合并字段插入到文档中:
使用相同的技术来插入嵌套在其他字段中的字段。
以下代码示例演示如何使用 DocumentBuilder 插入嵌套在另一个字段中的字段:
在字段级别指定区域设置
语言标识符是一个国家或地理区域的语言的标准国际数字缩写。使用 Aspose.Words,您可以使用 LocaleId 属性在字段级别指定区域设置,该属性获取或设置字段的区域设置 ID。
以下代码示例展示了如何使用此选项:
插入无类型/空字段
如果您想像 Microsoft Word 允许的那样插入非类型化/空字段 ({}),您可以使用带有 FieldType.FieldNone 参数的 InsertField 方法。要在 Word 文档中插入字段,可以按"Ctrl + F9"组合键。
以下代码示例展示了如何将空字段插入到文档中:
使用 FieldBuilder 将字段插入文档
在 Aspose.Words 中插入字段的另一种方法是 FieldBuilder 类。它提供流畅的界面来指定字段开关和参数值作为文本、节点甚至嵌套字段。
以下代码示例演示如何使用 FieldBuilder 将字段插入到文档中:
使用 DOM 插入字段
您还可以使用 Aspose.Words Document Object Model (DOM) 插入各种类型的字段。在本节中,我们将看一些示例。
使用 DOM 将合并字段插入到文档中
Word文档中的MERGEFIELD
字段可以用FieldMergeField类来表示。您可以使用 FieldMergeField 类执行以下操作:
- 指定合并字段的名称
- 指定合并字段的格式
- 指定合并字段的字段分隔符和字段结尾之间的文本
- 如果字段不为空,则指定要在合并字段后插入的文本
- 如果字段不为空,则指定要在合并字段之前插入的文本
以下代码示例演示如何使用 DOM 将 MERGE
字段添加到文档中的段落:
使用 DOM 将 Mail Merge ADDRESSBLOCK
字段插入文档中
ADDRESSBLOCK
字段用于在Word文档中插入mail merge地址块。 Word文档中的ADDRESSBLOCK
字段可以用FieldAddressBlock类来表示。您可以使用 FieldAddressBlock 类执行以下操作:
- 指定字段中是否包含国家/地区名称
- 指定是否根据 POST*CODE 定义的收件人国家/地区来格式化地址(Universal Postal Union 2006)
- 指定排除的国家/地区名称
- 指定姓名和地址格式
- 指定用于格式化地址的语言ID
以下代码示例演示如何使用 DOM 将 Mail Merge ADDRESSBLOCK
字段添加到文档中的段落:
在不使用 DocumentBuilder 的情况下将 ADVANCE
字段插入到文档中
ADVANCE
字段用于将行中的后续文本向左、向右、向上或向下偏移。 Word文档中的ADVANCE
字段可以用FieldAdvance类来表示。您可以使用 FieldAdvance 类执行以下操作:
- 指定字段后面的文本应从页面顶部边缘垂直移动的点数
- 指定字段后面的文本应从列、框架或文本框的左边缘水平移动的点数
- 指定字段后面的文本应向左、向右、向上或向下移动的点数
以下代码示例演示如何使用 DOM 将 ADVANCE
字段添加到文档中的段落:
在不使用 DocumentBuilder 的情况下将 ASK
字段插入到文档中
ASK
字段用于提示用户输入要分配给 Word 文档中的书签的文本。 Word文档中的ASK
字段可以用FieldAsk类来表示。您可以使用 FieldAsk 类执行以下操作:
- 指定书签的名称
- 指定默认用户响应(提示窗口中包含的初始值)
- 指定每个 mail merge 操作是否应接收一次用户响应
- 指定提示文本(提示窗口的标题)
以下代码示例演示如何使用 DOM 将 ASK
字段添加到文档中的段落:
在不使用 DocumentBuilder 的情况下将 AUTHOR
字段插入到文档中
AUTHOR
字段用于指定 Document
属性中文档作者的姓名。 Word文档中的AUTHOR
字段可以用FieldAuthor类来表示。您可以使用 FieldAuthor 类执行以下操作:
- 指定文档作者的姓名
以下代码示例演示如何使用 DOM 将 AUTHOR
字段添加到文档中的段落:
在不使用 DocumentBuilder 的情况下将 INCLUDETEXT
字段插入到文档中
INCLUDETEXT
字段插入字段代码中指定的文档中包含的文本和图形。您可以插入整个文档或书签引用的文档的一部分。 Word文档中的该字段由INCLUDETEXT表示。您可以使用 FieldIncludeText 类执行以下操作:
- 指定所包含文档的书签名称
- 指定文档的位置
以下代码示例演示如何使用 DOM 将 INCLUDETEXT
字段添加到文档中的段落:
在不使用 DocumentBuilder 的情况下将 TOA
字段插入到文档中
TOA
(权威表)字段构建并插入权威表。 TOA
字段收集由 TA
(权限表条目)字段标记的条目。当您在 References 选项卡上的 权限表 组中单击"插入权限表"时,Microsoft Office Word 会插入 TOA
字段。当您查看文档中的 TOA
字段时,语法如下所示:
{ TOA
[Switches ] }
以下代码示例演示如何使用 DOM 将 TOA
字段添加到文档中的段落: