用途
该技能用于在 ASP.NET MVC 应用中实现 Syncfusion PDF Viewer。它面向需要将 PDF 查看、批注、表单填写、搜索、打印等能力嵌入到 ASP.NET MVC 页面的开发者,通过生成可复制粘贴的 Razor + HTML 代码(.cshtml)来帮助完成集成。
触发关键词包括:"how to"、"add pdfviewer"、"code sample"、"show me"、"example"、"snippet"、"integrate"、"component"、"create sample"、"ASP.NET MVC sample"。
主要能力
- 文档加载与查看:从 URL、本地路径或 base64 加载 PDF;打开加密/密码保护的 PDF;支持程序化加载与加载失败处理(opening-pdfs.md)。
- 导航与交互:首页/末页/上一页/下一页/跳转页码、缩略图、超链接、目录导航、书签导航;交互模式(文本选择/平移)、页面滚动、平移操作(navigation.md、bookmark-navigation.md、viewing-and-interaction.md)。
- 缩放:缩放级别与百分比、适应页面/适应宽度/适应可见区域/自动等缩放模式、自定义缩放控件、鼠标滚轮缩放(magnification.md)。
- 工具栏定制:主工具栏、表单设计器工具栏、批注工具栏的启用/禁用与显示/隐藏;工具栏项目列表;自定义工具栏项(toolbar-customization.md、toolbar-reference.md、toolbar-customization-scenarios.md)。
- 批注与标记:墨迹/手写、便签/评论、手写/数字签名、文本标记(高亮、下划线、删除线、波浪线)、形状(直线、箭头、矩形、圆形、多边形)、测量(距离、周长、面积、半径、体积)、图章、自由文本;批注外观与行为设置、选择器定制、生命周期事件、程序化操作与导入导出(annotation-*.md 系列)。
- 敏感信息遮蔽(Redaction):按区域或整页标记,配置覆盖文本与样式,不可逆应用遮蔽,搜索文本并自动遮蔽(redaction-annotation.md)。
- 表单管理:填写与设计 PDF 表单,管理字段类型(文本框/密码/复选框/单选/下拉/列表框/签名),程序化创建字段,字段属性与校验规则,导入导出表单数据(form-*.md 系列)。
- 文本操作:文本搜索(大小写敏感/全词匹配、高亮结果、查找下一个/上一个、自定义高亮颜色)、文本提取、文本选择与复制(text-search.md、text-selection.md)。
- 文档操作:保存与下载(含批注/修改、表单数据、返回 base64、自定义文件名)、打印(页码范围/质量、静默打印)、页面组织(重排/旋转/删除、复制/提取页面)。
- 高级控制:完整的 API 方法(加载文档、管理表单、批注、提取文本、撤销/重做、导航)与事件列表(api-methods.md、events.md)。
使用方式
- NuGet 包:Syncfusion.EJ2.MVC5。
- 生成代码时要求:读取相关 references/*.md 参考文件,交叉核对每个 API、属性和方法;只使用参考文件表格中明确列出的内容。
- 参考文件路由:始终从 getting-started.md 开始,再合并匹配的功能到其锚点(PROPS、EVENTS、UI_BUTTONS、HANDLERS);若无关键词匹配,仅返回基础示例。
- 设置配置最佳实践:1-3 个属性用 Razor 内联;4 个及以上或使用枚举/复杂配置时用 HTML 外的 Razor 代码块;避免过度工程化。
- 生成前检查清单:统计设置属性数量、判断组件 prop 是否足够简单、默认值是否显式设置。
适用场景
- 在 ASP.NET MVC 项目中嵌入和配置 PDF 查看器。
- 需要生成 PDF Viewer 的可复制示例代码。
- 需要程序化操作 PDF:加载、批注、表单、搜索、下载、打印、页面组织。
限制
- 严格模式:只能使用参考文件中显式列出的 API 和属性,禁止自定义属性、臆造方法、未文档化 API 的变通方案、对未文档化行为的假设。
- 若请求的功能未在任何参考文件中列出,必须回复:"This feature is not supported in the current Syncfusion ASP.NET MVC PDF Viewer implementation.",然后列出参考文件中支持的内容。
- 若参考文件缺失或不可读,必须停止代码生成并提示参考文件不可用。