先前集成

当现有的 .NET Standard 应用仍然手动构造 Viewer、向中间件传递选项、通过共享文件夹协调 Web 农场，或将查看器脚本复制到应用中时，请使用本节。该架构仍为未迁移的客户提供文档。

包版本标识代数

仅凭包 ID 并不足够。两个代数都以 Doconut.NETStandard 发布：

在选择手册之前，请检查项目文件、锁定文件或缓存的 .nupkg 中的版本。仅标记为 Doconut.NETStandard 的包引用无法告诉您代码对应的是哪个 API。

识别先前的集成

当应用包含以下一种或多种签名时，即使用了先前的集成：

var viewer = new Viewer(_cache, _accessor);
var viewer = new Viewer(_cache, _accessor, licenseFilePath);

var token = viewer.OpenDocument(path, config, documentOptions);
viewer.InitCache();

appBranch.UseDoconut(new DoconutOptions { UnSafeMode = false, ShowDoconutInfo = false });

appBranch.UseDoconutWebFarm(new WebFarmOptions { Path = sharedFolder });

Viewer.DoconutLicense(licenseStream);
Viewer.SetLicensePlugin(pluginLicenseStream);

var converter = viewer.Converter.GetConverter();

其 using 块是另一个可靠信号——配置类型分布在多个命名空间中：

using Doconut.Configs;
using Doconut.Configs.View;
using Doconut.Configs.Cloud;
using Doconut.Models;

先前的页面通常还会加载由应用管理的以下副本：

docViewer.js
documentLinks.js
docViewer.UI.js

并将查看器回调声明为以容器 ID 命名的全局函数，例如 ctlDoc_OnViewerReady()。

当前的集成则通过 AddDoconut()、UseDoconutResources()、不带参数的 UseDoconut()、注入的 Viewer、OpenDocumentAsync()，以及扁平化的 Doconut 命名空间来识别。

打开保留的手册

已翻译的历史手册位于 旧版 .NET Standard 设置。其 URL 未被重定向或替换，因为它描述了仍在使用的真实集成代数。

请勿将该手册中的代码片段与当前的 AddDoconut() 文档混用。Viewer 的构造、中间件路由、许可证、资源、转换、Web 农场协调以及会话所有权均有所不同。

规划迁移

使用 迁移至 .NET Standard 2.1 来获取从手动构造和同步文档打开到 DI、当前中间件、异步会话、生成资源、分布式发布以及功能门控插件的验证映射。

在开始之前有两件事需要注意：

• 宿主框架。 netstandard2.1 需要 .NET Core 3.0 或更高版本。 .NET Framework 宿主根本无法使用当前包。
• 客户端更改。 其中两项会静默失败——服务器仍然工作，浏览器控制台保持为空。迁移指南中已有说明。

保持先前的部署完整，直至当前应用通过其文档、许可证、Search、Annotation、Converter、DICOM、安全性和回滚测试。