syncfusion-aspnetcore-pdf-viewer

用途

该技能面向在 ASP.NET Core 应用中嵌入 Syncfusion PDF Viewer 的场景，用于生成可复制粘贴的 Razor 与 HTML（.cshtml）示例代码，帮助完成 PDF 文档的嵌入、配置与加载。

依赖的 NuGet 包为：Syncfusion.EJ2.AspNet.Core。

主要能力

技能按功能域拆分参考文档，生成示例时可组合以下能力：

核心设置与配置：getting-started、enable-properties、general-properties，涵盖 documentPath、宽高、区域设置、缩放与初始渲染页，以及服务端集成设置（serviceUrl、ajaxRequestSettings、serverActionSettings）、资源加载（resourceUrl、customFonts）和性能/重试选项。
上下文菜单：文本、注释与表单字段的上下文菜单，支持 addCustomMenu 自定义项、customContextMenuSelect 处理点击、customContextMenuBeforeOpen 动态显隐，以及通过 contextMenuOption 禁用菜单。
导航：页面导航（首页/末页/上一页/下一页/跳转）、缩略图、超链接（内部与外部）、目录导航、编程式导航方法与相关事件；书签导航的启用/禁用与显隐，以及以编程方式获取文档书签。
查看与交互：交互模式（文本选择/平移）、页面滚动与查看行为、平移操作、模块化功能模块、查看类功能启停。
缩放：缩放级别与百分比、缩放模式（适合页面/适合宽度/适合可见区域/自动）、自定义缩放控件、编程式缩放、缩放工具栏与鼠标滚轮缩放。
工具栏：主工具栏、表单设计器工具栏、注释工具栏的定制；启用/禁用与显隐工具栏项；初始化时启用/禁用工具栏；创建自定义工具栏项；工具栏 API 参考与常见定制场景。
注释与标记：墨迹/手写、便签/评论、手写/数字签名；文本标记（高亮、下划线、删除线、波浪线）；形状（直线、箭头、矩形、圆形、多边形）；测量（距离、周长、面积、半径、体积）；图章；自由文本；以及注释外观与行为设置、选择器外观、作者/主题/自定义数据、生命周期事件与编程式操作（选择、移动与缩放、删除、锁定、导入导出）。
涂黑（Redaction）：按区域或整页标记、覆盖文本与样式配置、不可逆应用涂黑、文本搜索并自动涂黑、以编程方式管理涂黑注释。
表单管理：填写与设计 PDF 表单；字段类型（文本框、密码、复选框、单选、下拉、列表框、签名）；以编程方式创建字段；表单设计器工具栏与 UI 交互；字段属性与自定义；校验规则；表单数据导入导出（含自定义字段数据）；字段属性列表、操作、校验设置与字段级事件（聚焦、失焦、值变更、校验）。
文本操作：文本搜索（大小写敏感/全词匹配）、结果高亮、查找下一个/上一个、搜索完成事件、自定义高亮颜色、文本提取选项与按页提取；文本选择与提取、复制选中文本、选择事件与选择边界。
文档操作：从 URL/本地路径/base64 打开 PDF，打开加密或受密码保护的 PDF，加载事件与生命周期、加载失败处理；下载与保存（含注释/修改、含表单数据）、以 base64 获取、自定义下载文件名与事件；打印（页码范围/质量、静默打印）与页面组织（重排、旋转、删除、复制、提取到新文档、页面组织工具栏）。
高级能力：api-methods（以编程方式加载文档、管理表单与注释、提取文本、撤销/重做、导航）与 events（完整事件列表与处理）。

使用方式

技能声明了严格的工作流与约束：

仅依据参考文件生成代码。必须先读取相关的 references/*.md 文件，并确认其中包含 Methods、Properties、Events 表格；若参考文件缺失或不可读，须停止生成并提示补齐参考文件。
逐一交叉比对：每个 API、属性、方法都必须出现在参考文件表格中，否则不得使用；禁止编造、猜测或建议任何未在参考文件中明确出现的 API、方法、属性、类或命名空间。
遇到参考文件中未列出的场景或功能时，必须回复“当前 Syncfusion ASP.NET Core PDF Viewer 实现不支持该功能”，并列出参考文件中确实支持的内容。
生成前需自检：核对所用 API 的来源表格，无法引用表格条目的代码须删除。
路由规则：始终从 getting-started.md 开始，再将匹配到的功能合并到其锚点（PROPS、EVENTS、UI_BUTTONS、HANDLERS）；若无关键词匹配，仅返回基础示例。
设置配置建议：1–3 个属性时以内联 Razor 代码书写；4 个以上属性或涉及枚举、复杂配置、跨组件复用时，抽取为 HTML 外部的 Razor 代码块；避免为简单场景引入完整类型定义的过度工程化写法。

快速示例（来自资料）：

@page
@model IndexModel
@{
    ViewData["Title"] = "Home page";
}

<div class="text-center">
    <ejs-pdfviewer id="pdfviewer" style="height:600px"
        documentPath="https://cdn.syncfusion.com/content/pdf/pdf-succinctly.pdf"
        annotationAdd="annotationAdded" >
    </ejs-pdfviewer>
</div>

触发关键词包括："how to"、"add pdfviewer"、"code sample"、"show me"、"example"、"snippet"、"integrate"、"component"、"create sample"、"ASP.NET Core sample"。

适用场景

适用于需要在 ASP.NET Core 项目中添加 PDF 查看器、编写集成示例、配置工具栏/注释/表单/导航/涂黑等功能，或查询可用 API 与事件的开发者。

限制

严格以参考文件表格为唯一事实来源，不支持超出参考文件范围的 API 或功能。
参考文件不可用时无法生成代码。
资料未提供授权方式、收费与价格、支持平台版本范围、性能指标等具体信息。

技能介绍

用途

主要能力

使用方式

适用场景

限制