为 .NET 应用添加 PDF 注释和文本搜索
2026/3/6

为 .NET 应用添加 PDF 注释和文本搜索

了解如何在 .NET 应用中添加无需插件的 PDF 注释和文本层搜索,让审阅者能够标记文档并在不滚动的情况下找到短语。

在 PDF 上发表评论,并搜索其已有的文本——无需插件。


介绍

许多组织将 PDF 作为报告、研究论文、手册和技术图纸的主要文档格式。在许多 .NET 应用中,用户可以上传文件并在查看器中打开——但工作流程就在此止步。

传统的查看器仅提供 只读体验,使用户无法在文档上做标记或在不滚动的情况下找到特定短语。

通过为现代 无插件 PDF 查看器 添加 注释 和 文本搜索,.NET 应用可以让用户对文件发表评论,并直接跳转到所需段落——前提是 PDF 包含文本层,而大多数 PDF 都具备此层。

本文将探讨:

  • PDF 注释 如何提升文档审阅工作流
  • 全文搜索 如何读取 PDF 的文本层,以及哪些文件无法受益
  • 如何轻松将这些功能集成到 .NET 应用 中

您可以尝试查看器或下载 SDK:


1. PDF 注释 – 将静态页面转变为交互式文档

静态 PDF 的问题

许多团队在审阅文档时仍依赖低效的工作流:

  1. 打印 PDF
  2. 用笔在纸上标记
  3. 扫描文档
  4. 上传新版本

此过程会导致 版本混乱、延误以及不必要的人工工作。

解决方案:在查看器中加入注释层

在您的 .NET 门户中嵌入注释引擎,可让用户直接在文档上交互。

在功能表之前需要说明一个授权事项,因为它影响预算而非设计:注释是 Doconut Viewer 的 独立插件,不属于基础查看器。它是四大插件之一——注释、转换、DICOM 和搜索。下一节讨论的文本层搜索同样是 Search 插件。受控打印则是查看器本身的一部分。

功能好处
高亮、下划线、删除线快速强调重要文本
便签在文档内部直接添加上下文反馈
自由手绘适用于图表、技术草图和设计评审
带时间戳的注释跟踪更改添加的时间

注释不会修改原始文件,而是可以作为 独立的元数据层(例如 JSON) 与文档关联存储。

这种做法确保:

  • 原始 PDF 保持不变
  • 注释可以独立导出或删除
  • 文档仍是 唯一的真实来源

实际影响

注释显著提升文档工作流:

  • 更快的文档审阅
  • 在设计或研究讨论中提供更清晰的反馈
  • 减少对外部编辑工具的需求

2. 全文搜索 – PDF 必须携带的内容

两个外观相同的 PDF

并排打开两个扫描的合同,它们看起来可能一模一样。一个可搜索,另一个不可,而屏幕上没有任何提示告诉你哪个是哪个。

PDF 保存页面图像,同时另存 文本层:页面字符及其位置。几乎所有由 Word、报告生成器、业务系统导出或开启文字识别的扫描仪生成的 PDF 都包含该层。搜索会将你的短语与该层匹配,并在页面图像上高亮显示对应位置。

仅为页面照片的 PDF 则不包含此层。文件中没有文本,自然也就没有可供搜索匹配的内容。

查看器对文本层的处理

功能描述
文本层搜索将查询与文件中存储的字符匹配
匹配高亮在渲染页面上标记每个匹配位置
结果导航在整个文档中从一个匹配跳到下一个
任意文字读取层中的文字,无论是拉丁文还是其他

当文本层存在时:

  • 文本 可选中
  • 用户可以 复制内容
  • 全文 搜索可跨整个文件工作

当文本层缺失时,文件仍可正常打开和渲染;只是无法进行搜索。Doconut 目前不支持从页面图像中读取字符。

为什么这很重要

文档是否可搜索取决于它进入系统时是否已生成文本层,而不是在需要查找时才决定。几乎所有扫描仪和文档管理平台在摄取时都能写入文本层,拥有该层的文件在整个保存期间都保持有用。

在这样构建的档案库中,用户可以瞬间找到:

  • 技术规格
  • 法规条款
  • 科学参考文献
  • 历史记录

他们无需手动翻阅文档,只需 搜索并跳转到相关章节。


3. 在 .NET 应用中的简易集成

请参考 官方下载页面 中的包名、版本号以及初始化步骤,并结合随构建一起提供的文档。不同版本之间的变化以及从文章中复制的包行是导致首次集成因授权错误而失败的常见原因。

查看器兼容常见的 .NET 框架,包括:

  • ASP.NET Core
  • ASP.NET MVC
  • Blazor

配置完成后,您的应用即可在浏览器中直接显示 PDF。只要相应插件已授权并启用,注释和文本搜索功能便会出现。


4. 无插件且安全的设计

现代浏览器已不再支持 Flash、ActiveX 等传统插件。

现代 PDF 查看器必须 完全在 HTML5 和 JavaScript 中运行。

主要优势包括:

  • 无需客户端安装
  • 跨现代浏览器兼容
  • 支持桌面和移动设备

安全特性通常包括:

  • 仅限 HTTPS 通信
  • 基于令牌的身份验证
  • 受控的文档访问

这使得查看器适用于处理敏感文档的企业应用。


结论

静态 PDF 限制了团队对信息的使用方式。为 .NET 应用添加 注释 和 文本搜索,即可将只能阅读的文件转变为可评论、可搜索的文档。

主要收益包括:

  • 通过注释工具加快文档审阅
  • 在 PDF 包含文本层时实现全文搜索,这类 PDF 占大多数
  • 简单集成到现有 .NET 应用
  • 无插件的观看体验

如果您想进一步探索这些功能,可了解更多或下载产品:

为您的读者提供可以标记和搜索的 PDF,直接嵌入他们已经在使用的应用中。