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

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

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

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

Windows 部署与免费试用选项

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

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

为什么 Document Viewer Library 对 .NET 企业而言是颠覆性技术

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

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

Doconut 的 Document Viewer Library 通过单一的服务器端 .NET 组件解决上述全部问题，支持 33+ 文件类型——包括 DOCX、XLSX、PPTX、DWG、DXF——开箱即用。库在服务器端原生渲染每种格式，省去 Microsoft Office、Acrobat 或外部转换服务的依赖。由于渲染在服务器完成，敏感数据始终留在防火墙内，这对医疗、法律和金融等行业尤为关键。

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

这些能力让您能够用单一、易维护的库取代繁杂的第三方查看器、JavaScript 插件和外部转换服务，轻松支撑从少量用户到全企业级的部署规模。

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

以下是将 Doconut 的 Document Viewer Library 集成到 ASP.NET Core 应用的简要步骤：

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

上述步骤会在 Windows 环境下生成服务器端查看器，运行于 .NET 6。基于令牌的方式让客户端保持轻量：前端只需引用托管在 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 的 Document Viewer Library 为 .NET 团队提供了单一、安全且功能丰富的组件，用于渲染 PDF、Office 文件和 CAD 图纸，并配备批注、OCR 搜索和受控打印等高级功能。凭借服务器端处理、内置转换以及对 33 种以上文件格式的支持，您可以摆脱昂贵的第三方依赖，将敏感数据牢牢掌控在自己手中。

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