如何在 .NET 中处理字段

步骤 1：获取库

克隆仓库并构建 Aspose.Words.sln 在 Release 配置下，然后添加项目引用到 Aspose.Words.csproj 从您自己的 .NET 项目中，如在 安装指南。添加 using Aspose.Words; and using Aspose.Words.Fields; 在任何使用字段的文件顶部添加。

步骤 2：插入字段并读取其结果

DocumentBuilder.InsertField() 在光标处插入一个新字段，提供的重载可以立即更新字段的结果，或留待稍后更新。每个字段都是一个由三个标记节点 — FieldStart、Separator、FieldEnd 组成的 Field 实例，分别以 Field.Start / Field.Separator / Field.End 公开。Field.Type 确定它代表的 FieldType，Field.Result 和 Field.DisplayResult 保存最后计算的值，Field.Format 保存附加在代码上的任何格式开关，Field.GetFieldCode() 返回原始字段代码文本。

步骤 3：在程序化编辑后更新字段

Aspose.Words FOSS 在文档加载或保存时不会重新计算字段。 在应该更改字段结果的编辑之后，调用 Range.UpdateFields() 重新计算该范围内的所有字段——对整个文档使用 Document.Range.UpdateFields()——或对单个字段使用 Field.Update()。 Range.UnlinkFields() 在一次调用中将该范围内的所有字段转换为静态文本，Range.NormalizeFieldTypes() 在手动编辑后将字段的存储类型代码与实际字段代码进行对齐。

步骤 4：使用 FieldOptions 配置字段更新行为

Document.FieldOptions（一个 FieldOptions 实例）控制文档整体在更新过程中的字段行为：CurrentUser（一个 UserInformation 实例——Name、Initials、Address）提供作者和用户名相关字段读取的身份标识，DefaultDocumentAuthor 为作者相关结果提供种子，LegacyNumberFormat / UseInvariantCultureNumberFormat / PreProcessCulture / FieldUpdateCultureSource 控制数字和日期的格式。对于无人值守的流水线，分配 FieldOptions.UserPromptRespondent（一个 IFieldUserPromptRespondent），以防止像 ASK 和 FILLIN 这类提示驱动的字段因交互式输入而阻塞，并为 FieldOptions.FieldDatabaseProvider 分配自定义的 IFieldDatabaseProvider，以便从您自己的数据源而非真实数据库连接提供 DATABASE 字段的行。

步骤 5：使用回调跟踪字段更新

实现 IFieldUpdatingCallback（FieldUpdating 和 FieldUpdated），并将其分配给 FieldOptions，以在每次字段重新计算之前和之后立即运行代码——这对于审计批处理作业中具体哪些字段发生了变化非常有用。对于跨大型文档的进度报告，实现 IFieldUpdatingProgressCallback（Notify），它接收一个 FieldUpdatingProgressArgs，该对象公开 TotalFieldsCount、UpdatedFieldsCount 和 UpdateCompleted。

步骤 6：转换或删除字段

Field.Unlink() 将字段替换为其最后计算的结果，作为普通的静态文本，丢弃底层的字段代码——当您希望该值永久写入文档时使用它。Field.Remove() 删除 FieldStart、Separator 和 FieldEnd 节点以及字段的代码和结果，彻底移除字段。相比直接删除标记节点，更建议使用这两种方法，因为手动只删除字段结构的一部分可能导致文档树不一致。