使用文档查看器库 – 支持 PDF、Office 和 CAD 格式，内置批注、搜索和打印功能：实用指南

Doconut 的文档查看器库让您能够渲染 PDF、Office 和 CAD 文件，对其进行批注、搜索内容并打印——全部由单一的 .NET 组件完成。
如果您正在构建以文档为中心的门户、法律科技案件管理器或工程图纸审阅工具，您需要一个能够以用户的方式工作：即时、安全且无需外部服务的查看器。Doconut 在本地提供这种体验，可嵌入您的 ASP.NET 或 .NET Core 应用，同时保持代码库简洁，部署体积小巧。

在本实用指南中，我们将逐步讲解文档查看器库的核心工作流，展示如何嵌入它，并演示使其不可或缺的三大支柱——批注、搜索（包括 OCR）和受控打印。结束时，您将拥有一个可直接运行的原型，并清晰了解 Doconut 如何成为任何文档密集型企业解决方案的支柱。

安全的企业文档查看器，展示带有批注和打印工具的 PDF、Office 和 CAD 文件

Windows 部署和免费试用选项

Doconut 的库运行在 .NET 6 上，并在 Windows 环境中得到完整支持。无论您将应用托管在 Azure、AWS 还是本地，它都能提供一致的渲染和批注性能。

为了快速入门，Doconut 提供了包含完整批注引擎、OCR 启用搜索和受控打印功能的 免费试用。在官方网站注册，下载试用许可证，并按照以下集成步骤，即可在几分钟内看到库的实际运行效果。

为什么文档查看器库是 .NET 企业的颠覆性创新

管理合同、工程图纸或员工记录的企业面临三大常见挑战：

格式多样性 – PDF、Word 文档、Excel 表格和 CAD 图纸共存于同一仓库。
协作审阅 – 业务用户需要在不离开应用的情况下对文档进行高亮、评论或盖章。
受监管的访问 – 打印必须可审计，且即使是扫描图像也必须提供可搜索的文本。

Doconut 的文档查看器库通过 单一的服务器端 .NET 组件 解决了上述所有问题，开箱即支持 33 种以上文件类型——包括 DOCX、XLSX、PPTX、DWG 和 DXF。该库原生渲染每种格式，省去 Microsoft Office、Acrobat 或外部转换服务的需求。由于渲染在服务器上进行，您可以将敏感数据保留在防火墙内，这对医疗、法律和金融等行业至关重要。

内置批注引擎 允许您直接在查看器画布上添加高亮、手绘或盖章批准。批注以轻量级 XML 存储，便于持久化到数据库或版本控制系统。搜索插件 提供对任何打开文档的即时全文搜索；当源文件为扫描图像时，OCR 引擎会实时提取可搜索的字符串。最后，受控打印 功能让您通过单一 API 调用即可强制页面范围限制、水印或打印审计日志。

这些功能的结合使您能够用 单一、易维护的库 替代繁杂的第三方查看器、JavaScript 插件和外部转换服务，轻松从少量用户扩展到企业级部署。

嵌入查看器：ASP.NET Core 中的逐步集成

以下是将 Doconut 的文档查看器库集成到 ASP.NET Core 应用所需步骤的简要说明：

注册 Doconut 中间件 – 配置 UseDoconut 中间件以处理内部图像瓦片端点（DocImage.axd）。该端点以 PNG 瓦片流式传输渲染页面，即使是大型 CAD 文件也能保持 UI 响应。
加载许可证 – 提供 Doconut 许可证文件（例如 DoconutLicense.xml），可以是磁盘上的文件或流。库会在创建第一个查看器实例时自动读取许可证。
创建查看器实例 – 实例化 Viewer 类，并传入所需的服务，如分布式缓存或 HTTP 上下文访问器。
配置渲染选项 – 设置配置对象（例如 PdfConfig），以控制默认渲染行为、超链接提取以及 CAD 图纸的光栅分辨率。
打开文档 – 调用 OpenDocument 方法，传入文件路径（或流）以及前面定义的配置。该方法返回一个安全令牌，JavaScript 前端使用该令牌请求页面图像、批注和搜索结果。

这些步骤将在运行 .NET 6 的 Windows 环境中生成 服务器端查看器。基于令牌的方式保持客户端轻量：前端只需引用托管在 https://doconut.app 的 Doconut 查看器组件。

内置批注用于实时审阅工作流

批注将被动的查看器转变为协作工作空间。Doconut 的批注管理器按页面操作，并将所有内容以 XML 形式存储，这意味着您可以轻松在数据库中进行版本控制、审计或合并更改。

典型批注工作流

通过调用查看器的 GetAnnotationManager 方法并提供页面尺寸，获取当前页面的批注管理器。
创建批注对象（例如图像印章、高亮或手绘），并设置其位置、大小和视觉属性。
将批注添加到管理器中。
使用 GetAnnotationXml 获取批注 XML 并将其存储到数据存储中。
当文档重新打开时，使用 LoadAnnotationXML 将保存的 XML 加载回查看器。

企业场景

法律科技 – 律师在合同上放置“签名”印章，然后将 XML 提交给案件管理服务进行审计。
工程审阅 – 设计师直接在 DWG 页面上添加红线图纸；批注 XML 与修订历史一起存储。
人力资源与招聘 – 招聘人员高亮简历关键部分，添加评论，并将带批注的版本推送到候选人档案。

由于批注数据存储在服务器上，您可以 完全控制 谁可以编辑、查看和打印。API 刻意保持简洁：只需使用管理器的获取、添加和加载方法，即可在此基础上构建额外的 UI 功能（撤销/重做、自定义工具），而无需引入额外依赖。

即时搜索与 OCR：让每个文档可被检索

文档仓库只有在用户能够在秒内定位所需信息时才有价值。Doconut 的搜索插件提供对任何打开文件的 即时全文搜索。对于仅包含光栅的 PDF 或扫描的 CAD 图纸，内置 OCR 引擎按需提取文本，将图像转化为可搜索内容，无需额外的预处理步骤。

典型搜索工作流

使用搜索插件暴露的查看器搜索方法，传入所需关键字。
接收匹配的页码列表以及每个匹配项的坐标。
对于每个匹配项，获取该页的批注管理器，并添加临时高亮批注，以向用户展示该词出现的位置。

当用户打开发票的扫描 PDF 时，查看器会在渲染每页时自动运行 OCR。提取的文本被存入内存索引，使后续搜索 瞬时完成。此方法消除了对独立 OCR 服务的需求，降低了延迟，并确保可搜索文本永不离开您的安全环境。

企业收益

客户门户 可以通过一次键击显示合同中的相关条款。
财务报告工具 让分析师在数十份扫描报表中定位特定行项目。
医疗记录系统 能够在扫描的医生笔记中搜索药物名称，提高患者安全性。

所有这些均通过 零第三方依赖 实现，使技术栈保持轻量，合规风险最小化。

从查看器进行受控打印 – 安全与便利的结合

打印往往是文档安全的薄弱环节。Doconut 的受控打印功能让您能够决定文档 何时、何地、如何 打印，同时仍提供熟悉的基于浏览器的打印对话框。

典型打印工作流

定义 PrintConfig 对象，指定页面范围限制、水印以及是否记录每次打印请求等选项。
将配置与文档令牌一起传递给查看器的 Print 方法。
查看器在服务器上渲染选定页面，应用水印，并将可打印的 PDF 流式返回至客户端浏览器。
系统自动创建审计条目，管理员可追踪谁在何时打印了什么。

通过在服务器端处理打印，Doconut 确保原始文档永不离开受保护的环境，并让您对打印活动拥有完整可视性——这对受监管行业至关重要。

结论

Doconut 的文档查看器库为 .NET 团队提供了一个 单一、安全且功能丰富的组件，用于渲染 PDF、Office 文件和 CAD 图纸，并通过批注、OCR 启用搜索和受控打印进行增强。凭借服务器端处理、内置转换以及对超过 33 种文件格式的支持，您可以消除昂贵的第三方依赖，确保敏感数据直接受您掌控。

准备好现代化您的企业文档工作流了吗？立即开始 Doconut 的免费试用，下载库并按照上述集成步骤，在几分钟内为您的 .NET 应用带来强大的查看、批注和搜索功能。