mcpField
S
syncfusion-aspnetcore-pivot-table

syncfusion-aspnetcore-pivot-table

github.com/syncfusion数据与数据库0106 次安装3 周前更新
代码仓库

关于 syncfusion-aspnetcore-pivot-table

面向 ASP.NET Core 应用的 Syncfusion PivotView 实现技能,用于构建多维数据分析与交互式报表。内容涵盖数据源、分析操作、界面配置及导出,并强调核对参考文件和验证数据源。

主要功能

  1. 01配置行、列、值和筛选轴
  2. 02聚合、排序、分组与过滤
  3. 03支持钻取和计算字段
  4. 04字段列表与分组栏交互
  5. 05虚拟滚动、分页与导出

适用场景

  1. 01构建交互式数据透视报表
  2. 02分析大型数据集并进行分页
  3. 03从可信数据源绑定报表数据
  4. 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.md
calculated-field.md
classic-layout.md
conditional-formatting.md
data-binding.md
data-compression.md
defer-update.md
drill-down.md
drill-through.md
editing.md
elasticsearch.md
excel-export.md
field-list.md
filtering.md
getting-started.md
grouping-bar.md
grouping.md
hyper-link.md
mongodb.md
mssql.md
mysql.md
number-formatting.md
olap.md
oracle.md
paging.md
pdf-export.md
performance-best-practices.md
pivot-chart.md
postgresql.md
print.md

详细介绍

实现数据透视表(ASP.NET Core)

Syncfusion ASP.NET Core Pivot Table(PivotView)支持通过交互式行/列/值轴、实时聚合、灵活筛选和全面的导出选项,实现多维数据可视化与分析。

⚠️ 重要提示: 请始终查阅此技能中的参考文件(references/*.md),核实 API 类名、属性和方法签名。这些文件包含经过验证且可正常运行的示例。请勿假设其他来源中的 API 详细信息正确。

⚠️ 安全警告:数据源验证

重要安全提示: 实现数据透视表时,务必使用可信数据源。切勿在未进行适当验证和清理的情况下,从不可信或用户提供的 URL 获取或绑定数据。

安全最佳实践:
  1. 使用本地数据:优先使用本地内存数据源,以确保最高安全性
  2. 验证远程数据源:仅连接到由你控制、经过身份验证和授权的 API 端点
  3. 清理用户输入:切勿允许用户指定任意 URL 或数据源
  4. 使用配置:将连接字符串和 API URL 存储在安全配置中(使用 IConfiguration 读取 appsettings.json)
  5. 实现身份验证:要求所有数据库和 API 连接都经过身份验证
  6. 实施授权:使用 [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 - 切换字段列表 UI
  • ShowGroupingBar - 切换分组栏 UI
  • EnableValueSorting - 允许对值单元格排序
  • AllowExcelExport、AllowPdfExport - 导出功能
  • AllowMemberFilter、AllowLabelFilter、AllowValueFilter - 筛选器类型
  • EnableSorting、EnableVirtualization - 性能和交互

相关技能

  • implementing-syncfusion-aspnetcore-components - 父级库技能

评论

支持 Markdown