文档自动化字段（IF、COMPARE、MACROBUTTON 等）

文档自动化字段（IF、COMPARE 等）

本指南展示了如何在 Word 的文档自动化字段系列中工作 Aspose.Words FOSS 用于 .NET – 这些字段用于驱动条件文本、存储文档范围的变量，并将宏、导航和打印行为串联起来，而不仅仅是显示计算值。每个都是一个 Field 子类位于 Aspose.Words.Fields 命名空间： FieldIf, FieldCompare, FieldDocVariable, FieldGoToButton, FieldMacroButton，以及 FieldPrint. Field 在以下描述的成员 使用字段 – GetFieldCode(), Update(), Remove(), Unlink(), Start/Separator/End, Result, 和 Format – 本页涵盖每个的特定内容。

使用 FieldIf 的条件文本

FieldIf 实现 IF 字段。 LeftExpression, ComparisonOperator, 和 RightExpression 描述条件 – 同样的三部分结构用于 IComparisonExpressionEvaluator (见 使用字段) – 和 TrueText / FalseText 保留两种可能的结果。调用 EvaluateCondition() 直接评估条件；它返回一个 FieldIfComparisonResult 值： True, False，或 Error.

使用 FieldCompare 比较值

FieldCompare 实现了 COMPARE 字段。类似于 FieldIf，它公开了 LeftExpression、ComparisonOperator 和 RightExpression 来描述比较，但产生布尔式结果，而不是在两个文本备选项之间切换。

使用 FieldDocVariable 的文档变量

FieldDocVariable 实现了 DOCVARIABLE 字段，通过其 VariableName 属性读取命名的文档范围变量。

按钮：FieldGoToButton 和 FieldMacroButton

FieldGoToButton 实现了 GOTOBUTTON 字段：Location 用于指定书签、页面或其他跳转目标，DisplayText 是文档中显示的标签。FieldMacroButton 实现了 MACROBUTTON 字段：MacroName 指定要运行的宏，DisplayText 是标签。FieldIf 和 FieldMacroButton 还实现了 IMergeFieldSurrogate，即 Word 的邮件合并感知字段用来将自身标记为可替换内容的接口。

使用 FieldPrint 的打印指令

FieldPrint 实现了 PRINT 字段：PrinterInstructions 和 PostScriptGroup 保存直接嵌入文档的特定打印机指令。

提示与最佳实践

• 使用 FieldIf.EvaluateCondition() 读取条件的结果（FieldIfComparisonResult），无需自行解析 TrueText/FalseText。
• FieldCompare 和 FieldIf 共享相同的 LeftExpression/ComparisonOperator/ RightExpression 结构——构建或检查比较表达式的代码可以在两种字段类型之间复用。
• 请记住，这些都是 Field 子类： GetFieldCode(), Update(), Remove()，并且 Unlink() from 使用字段 在此以完全相同的方式应用。

常见问题

FAQ

如何读取条件 IF 字段的结果？

调用 FieldIf.EvaluateCondition() 获取原始的 FieldIfComparisonResult，或读取 TrueText / FalseText 以获取字段在两种文字替代之间切换时的内容。

FieldIf 与 FieldCompare 有何区别？

FieldIf（IF 字段）根据其条件在 TrueText 和 FalseText 之间切换。FieldCompare（COMPARE 字段）具有相同的比较结构，但生成布尔型结果而非替代文本。

如何从 DOCVARIABLE 字段读取文档变量的名称？

阅读 FieldDocVariable.VariableName。

如何查找 GOTOBUTTON 字段的目标位置？

阅读 FieldGoToButton.Location；DisplayText 提供文档中按钮显示的标签。

API Reference 摘要

另请参阅

• Aspose.Words for .NET — Enterprise Documentation