如何在 .NET 中使用 Word 链接和引用

步骤 1：安装软件包

Aspose.Words FOSS for .NET 尚未发布 NuGet 包——请改为从源码构建库。克隆 https://github.com/aspose-words-foss/Aspose.Words-FOSS-for-.NET.git，然后使用 .NET SDK 在 Release 配置下构建 Aspose.Words.sln，并在项目中引用生成的 Aspose.Words 程序集。该库面向 .NET Standard 2.0，因此可在 .NET Framework 4.6.2+ 和 .NET 6/8/10 上运行。

步骤 2：导入必需的类

为 Document 和 DocumentBuilder 添加 using Aspose.Words; 指令，并为 FieldHyperlink、FieldRef、FieldPageRef、FieldNoteRef、FieldStyleRef、FieldSet、FieldAsk、FieldFillIn、FieldCitation、FieldBibliography 以及本指南涉及的其他字段类添加 using Aspose.Words.Fields; 指令。

步骤 3：插入超链接

对于一个直接的超链接，调用 DocumentBuilder.InsertHyperlink(displayText, urlOrBookmark, isBookmark) —— 将 isBookmark: false 作为 URL 目标传入，或将 true 用于链接到同一文档中的书签。当需要快捷方式未公开的属性时，可直接构造一个 FieldHyperlink：Address 和 SubAddress 保存目标 URL 或文档内位置，ScreenTip 设置悬停提示，OpenInNewWindow 和 IsImageMap 为显示标志，Target 指定浏览器框架。

步骤 4：创建书签以供引用

在书签应覆盖的内容之前调用 DocumentBuilder.StartBookmark(bookmarkName)，在其之后调用 DocumentBuilder.EndBookmark(bookmarkName)，两次调用使用相同的名称。DocumentBuilder.MoveToBookmark(bookmarkName) 将光标移动到已存在的书签——这在在其附近插入交叉引用字段之前定位位置时很有用。

步骤 5：插入对该书签的交叉引用

FieldRef（REF 字段）、FieldPageRef（PAGEREF）以及 FieldNoteRef（NOTEREF）均通过其 BookmarkName 属性解析为指定书签处的内容。将 InsertHyperlink 设置为使引用可点击，将 InsertRelativePosition 设置为报告相对位置（“上方”/“下方”），而不是引用的文本本身。FieldRef 还支持段落编号选项——InsertParagraphNumber、InsertParagraphNumberInFullContext、InsertParagraphNumberInRelativeContext、NumberSeparator——以及 IncludeNoteOrComment。FieldStyleRef（STYLEREF）解析为最近的使用给定 StyleName 格式的段落，而非书签，并可通过 SearchFromBottom 从字段位置向后搜索。FieldSet（SET）定义了一个书签文本值——BookmarkName 和 BookmarkText——可供其他位置的 REF 字段解析。

步骤 6：在更新时提示输入值

FieldAsk (ASK）并 FieldFillIn (FILLIN）请求更新字段的人员提供值：设置 PromptText 到向用户显示的文本， DefaultResponse 作为回退值，且 PromptOnceOnMailMerge 以限制邮件合并期间的重复提示。 FieldAsk 此外将其答案存储在 BookmarkName 以便其他字段可以引用它。对于无人值守的字段更新，请以编程方式提供答案，而不是交互式提示；请参阅 字段指南 了解执行此操作的回调接口。

步骤 7：引用外部或链接内容

FieldDde（DDE）和 FieldDdeAuto（DDEAUTO）通过 ProgId、SourceFullName 和 SourceItem 链接到另一个应用程序中的内容，InsertAsText、InsertAsHtml、InsertAsPicture、InsertAsRtf、InsertAsUnicode 和 InsertAsBitmap 用于选择插入的表示形式，AutoUpdate / IsLinked 控制刷新行为。FieldLink（LINK）是 OLE 链接的等价物，添加了 FormatUpdateType。FieldImport（IMPORT）和 FieldIncludePicture（INCLUDEPICTURE）通过 SourceFullName 和 GraphicFilter 拉入外部图形。FieldInclude（INCLUDE）和 FieldIncludeText（INCLUDETEXT）拉入外部文档内容，使用 BookmarkName 来限定包含的范围，使用 LockFields 防止其被刷新；FieldIncludeText 还通过 Encoding、MimeType、NamespaceMappings、XPath 和 XslTransformation 支持 XML 源。

步骤 8：引用构建块和术语表条目

FieldAutoText（AUTOTEXT），FieldAutoTextList（AUTOTEXTLIST），和 FieldGlossary（GLOSSARY）都通过 EntryName 引用一个已命名的构建块条目；FieldAutoTextList 为其列表式呈现添加了 ListStyle 和 ScreenTip。

步骤 9：插入引用和参考文献字段

FieldCitation (CITATION）以及 FieldBibliography (BIBLIOGRAPHY) 渲染来自文档参考文献数据的内容。设置 FieldCitation.SourceTag (或备用的 AnotherSourceTag)以识别它引用的来源，并使用 Prefix, Suffix, PageNumber, VolumeNumber，以及 Suppress* 标志（SuppressAuthor, SuppressTitle, SuppressYear)来控制引用的格式。 FieldBibliography.SourceTag, FilterLanguageId，以及 FormatLanguageId 控制哪些来源出现在渲染后的参考文献中以及使用何种语言。这些字段只有在匹配到相应的 Source 记录存在 —— 请参阅 参考文献指南 用于构建这些。