关于 syncfusion-aspnetcore-pivot-table
面向 ASP.NET Core 应用的 Syncfusion PivotView 实现技能,用于构建多维数据分析与交互式报表。内容涵盖数据源、分析操作、界面配置及导出,并强调核对参考文件和验证数据源。
主要功能
- 01配置行、列、值和筛选轴
- 02聚合、排序、分组与过滤
- 03支持钻取和计算字段
- 04字段列表与分组栏交互
- 05虚拟滚动、分页与导出
适用场景
- 01构建交互式数据透视报表
- 02分析大型数据集并进行分页
- 03从可信数据源绑定报表数据
- 04导出透视表或打印报表
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ syncfusion/ aspnetcore-ui-components-skills --skill syncfusion-aspnetcore-pivot-table安装后在 Claude Code 中输入/syncfusion-aspnetcore-pivot-table确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
references/aggregation.mdcalculated-field.mdclassic-layout.mdconditional-formatting.mddata-binding.mddata-compression.mddefer-update.mddrill-down.mddrill-through.mdediting.mdelasticsearch.mdexcel-export.mdfield-list.mdfiltering.mdgetting-started.mdgrouping-bar.mdgrouping.mdhyper-link.mdmongodb.mdmssql.mdmysql.mdnumber-formatting.mdolap.mdoracle.mdpaging.mdpdf-export.mdperformance-best-practices.mdpivot-chart.mdpostgresql.mdprint.md详细介绍
实现数据透视表(ASP.NET Core)
Syncfusion ASP.NET Core Pivot Table(PivotView)支持通过交互式行/列/值轴、实时聚合、灵活筛选和全面的导出选项,实现多维数据可视化与分析。
⚠️ 重要提示: 请始终查阅此技能中的参考文件(
references/*.md),核实 API 类名、属性和方法签名。这些文件包含经过验证且可正常运行的示例。请勿假设其他来源中的 API 详细信息正确。
⚠️ 安全警告:数据源验证
重要安全提示: 实现数据透视表时,务必使用可信数据源。切勿在未进行适当验证和清理的情况下,从不可信或用户提供的 URL 获取或绑定数据。
安全最佳实践:
- 使用本地数据:优先使用本地内存数据源,以确保最高安全性
- 验证远程数据源:仅连接到由你控制、经过身份验证和授权的 API 端点
- 清理用户输入:切勿允许用户指定任意 URL 或数据源
- 使用配置:将连接字符串和 API URL 存储在安全配置中(使用 IConfiguration 读取 appsettings.json)
- 实现身份验证:要求所有数据库和 API 连接都经过身份验证
- 实施授权:使用 [Authorize] 特性和基于角色的访问控制
安全风险:
- 间接提示词注入:不可信的第三方数据可能包含恶意内容,从而操控 AI Agent 的行为
- 数据泄露:未经验证的远程连接可能暴露敏感信息
- SQL 注入:未经清理的数据库查询可能导致数据泄露
- XSS 攻击:在 UI 中呈现未经转义的数据可能会执行恶意脚本
✅ 安全: 本地数据、由你控制且经过身份验证的 API、参数化 SQL 查询 ❌ 不安全: 用户提供的 URL、未经身份验证的端点、硬编码的连接字符串
何时使用此技能
在构建 ASP.NET Core 应用程序,且用户需要以下功能时,请使用此技能:
- 透视报表,包含行、列、值和筛选轴
- 数据聚合,支持 20 多种汇总类型(Sum、Avg、Count、Percentage、RunningTotals 等)
- 交互式报表构建,通过字段列表和分组栏 UI 实现
- 数据源绑定(本地 JSON/CSV、SQL Server、OLAP、关系数据库)
- 筛选(成员、标签、值筛选,支持搜索/排序)
- 排序(字段排序、自定义顺序、值排序)
- 高级功能(下钻/上钻、钻取、计算字段、数据透视图表)
- 格式设置(条件格式、数字格式、自定义样式)
- 导出(Excel、PDF、CSV、打印)
- 性能优化(虚拟滚动、分页、数据压缩)
触发关键词: 数据透视表、pivotview、PivotView、字段列表、分组栏、OLAP、数据透视聚合、数据透视导出、数据透视下钻、数据透视报表、ASP.NET Core 数据透视
快速入门示例
@using Syncfusion.EJ2.PivotView
<ejs-pivotview id="pivotview"
height="450"
showFieldList="true"
showGroupingBar="true">
<e-datasourcesettings dataSource="@ViewBag.DataSource">
<e-rows>
<e-field name="Country" caption="Country"></e-field>
</e-rows>
<e-columns>
<e-field name="Year" caption="Year"></e-field>
</e-columns>
<e-values>
<e-field name="Sales" caption="Total Sales" type="Sum"></e-field>
</e-values>
<e-filters>
<e-field name="Region" caption="Region"></e-field>
</e-filters>
<e-formatsettings>
<e-field name="Sales" format="C0" currency="USD"></e-field>
</e-formatsettings>
</e-datasourcesettings>
</ejs-pivotview>
导航指南
开始使用和设置
📄 阅读: references/getting-started.md
- 安装和 NuGet 包设置
- 项目配置和命名空间注册
- PivotView 基本初始化
- 主题和样式设置
数据透视和数据绑定
📄 阅读: references/data-binding.md
- 本地/远程数据绑定模式
- CSV 和 JSON 数据源
- DataManager 配置
- 字段映射和设置
数据源连接
📄 阅读: references/mysql.md
- MySQL 数据库设置、连接配置、Web API 实现
- DataAdapter 模式、JSON 序列化
📄 阅读: references/mssql.md
- SQL Server 设置、身份验证方法、Azure SQL Database 集成
- T-SQL 查询、存储过程
📄 阅读: references/postgresql.md
- PostgreSQL 连接字符串、SSL/TLS 配置
- 查询模式、连接池
📄 阅读: references/oracle.md
- Oracle 数据库设置、TNS 配置、身份验证
- SQL 和 PL/SQL 查询
📄 阅读: references/mongodb.md
- MongoDB 文档数据库、BSON 文档处理
- POCO 模型映射、批量操作
📄 阅读: references/elasticsearch.md
- Elasticsearch 搜索引擎、NEST 客户端库
- 查询 DSL 模式、索引管理
📄 阅读: references/snowflake.md
- Snowflake 云数据仓库、虚拟仓库配置
- 成本优化、半结构化数据
高级数据源
📄 阅读: references/olap.md
- OLAP 多维数据集设置和层次数据绑定
- 维度和度量值配置
- 数据透视引擎集成
📄 阅读: references/server-side-pivot-engine.md
- 服务端处理和聚合
- 后端大型数据集优化
- 批处理工作流
数据整形和分析
📄 阅读: references/aggregation.md
- 汇总类型:Sum、Avg、Count、Min、Max、Product、Median、StDev、Variance
- 百分比计算和累计总计
- 运行时自定义聚合
📄 阅读: references/calculated-field.md
- 在公式中定义和使用计算字段
- 运行时创建和更新字段
- 性能注意事项
📄 阅读: references/grouping.md
- 按日期、值范围进行字段级分组
- 用于维度层次结构的轴分组
📄 阅读: references/filtering.md
- 使用包含/排除条件筛选成员
- 标签筛选(字符串、日期、数值)
- 对聚合数据进行值筛选,包括 Top N 和 Bottom N 运算符
📄 阅读: references/sorting.md
- 成员字段排序(升序/降序)
- 自定义成员顺序配置
- 对计算单元格进行值排序
📄 阅读: references/drill-through.md
- 访问透视单元格背后的底层数据
- 钻取事件处理
可视化和布局
📄 阅读: references/pivot-chart.md
- 将透视图表绑定到透视表数据
- 图表类型选择和配置
📄 阅读: references/classic-layout.md
- 经典(紧凑)布局渲染
- 紧凑、轮廓和树形布局选项
📄 阅读: references/drill-down.md
- 深入查看维度成员
- 在层次结构级别之间向上钻取导航
📄 阅读: references/row-and-column.md
- 行轴和列轴配置
- 值字段定位
格式和显示
📄 阅读: references/number-formatting.md
- 使用货币、小数和百分比格式设置值单元格
- 自定义数字格式提供程序
📄 阅读: references/conditional-formatting.md
- 根据值或条件应用样式规则
- 色阶和数据条
📄 阅读: references/hyper-link.md
- 用于导航的超链接列
- 自定义 URL 生成和点击处理
用户界面控件
📄 阅读: references/grouping-bar.md
- 启用/禁用分组栏
- 拖放字段配置
- 分组栏事件处理
📄 阅读: references/field-list.md
- 字段列表弹出模式和固定模式
- 字段搜索和排序
- 按文件夹对字段分组
📄 阅读: references/defer-update.md
- 批量更改,无需中间更新
- 大量更改字段时提升性能
📄 阅读: references/tool-bar.md
- 工具栏按钮配置
- 内置和自定义命令
- 导出和操作按钮
📄 阅读: references/tool-tip.md
- 单元格和表头工具提示
- 自定义工具提示内容
编辑和数据操作
📄 阅读: references/editing.md
- 单元格就地编辑工作流
- 从数据透视表更新底层数据
- 单元格编辑事件处理
性能和优化
📄 阅读: references/virtual-scrolling.md
- 对大型数据透视表进行虚拟滚动
- 节省内存的渲染方式
📄 阅读: references/paging.md
- 分页配置
- 页面大小和导航
📄 阅读: references/data-compression.md
- 压缩传输数据的负载
- 带宽优化
📄 阅读: references/performance-best-practices.md
- 大型数据集调优指南
- 服务端与客户端渲染决策
- 常见性能瓶颈及解决方法
状态和持久化
📄 阅读: references/state-persistence.md
- 保存数据透视表报表状态
- 加载已保存的配置
- 状态存储选项
导出和打印
📄 阅读: references/print.md
- 使用自定义设置打印数据透视表
- 打印预览和页面布局
📄 阅读: references/excel-export.md
- 导出为 Excel 工作簿
- 格式设置和多工作表导出
📄 阅读: references/pdf-export.md
- 导出为 PDF 文档
- 页面方向和尺寸
常见模式
模式 1:包含所有 UI 的完整数据透视表:
- 启用
ShowFieldList、ShowGroupingBar和工具栏按钮 - 用户可以交互式地构建和优化报表
模式 2:大型数据集的服务端聚合:
- 使用服务端数据透视引擎进行后端处理
- 启用分页和虚拟滚动,以实现响应灵敏的 UX
模式 3:只读分析视图:
- 禁用字段列表和分组栏
- 设置固定的行/列/值配置
- 仅使用下钻进行探索
关键属性概览
DataSourceSettings- 数据源和字段配置Rows、Columns、Values、Filters- 轴字段数组ShowFieldList- 切换字段列表 UIShowGroupingBar- 切换分组栏 UIEnableValueSorting- 允许对值单元格排序AllowExcelExport、AllowPdfExport- 导出功能AllowMemberFilter、AllowLabelFilter、AllowValueFilter- 筛选器类型EnableSorting、EnableVirtualization- 性能和交互
相关技能
implementing-syncfusion-aspnetcore-components- 父级库技能