syncfusion-wpf-spreadsheet-editor

Syncfusion WPF 电子表格编辑器

概述

使用 Syncfusion SfSpreadsheet 控件在 WPF 中构建类似 Excel 的电子表格应用，全面支持工作簿操作、公式、图表、数据验证和功能区自定义。

主要功能

• 工作簿操作： 创建、打开和保存 Excel 文件（XLS、XLSX、XLSM、CSV），支持多个工作表、冻结窗格、缩放和保护
• 单元格操作： 编辑、格式设置（字体、颜色、边框、对齐方式）、合并单元格、批注、超链接、书签
• 数据功能： 400 多个兼容 Excel 的公式、命名范围、数据验证、条件格式、填充序列
• 高级功能： 图表、迷你图、剪贴板操作、撤消/重做、分组/大纲
• 转换： 导出为 PDF、HTML、图像、CSV

快速入门示例

示例 1

用户：“展示如何创建包含数据和公式的电子表格”

**结果：**生成用于创建工作簿、设置单元格值和添加公式的 C# 代码

示例 2

用户：“在电子表格控件中添加数据验证和规则”

**结果：**生成用于电子表格控件验证和自定义规则的 C# 代码

---

生成 WPF 代码 — 工作流

触发关键词：“如何”、“添加电子表格”、“代码示例”、“展示”、“示例”、“代码片段”、“集成”、“组件”、“创建示例”、“代码”、“示例代码”、“生成代码”、“实现”、“添加到项目”、“配置电子表格”

步骤 1：询问用户选择的交付方式

展示代码前，先询问：

"How would you like me to provide the solution?

Option 1: Create a new file in skill folder (.codestudio/skills/wpf-spreadsheet-editor/output/)
Option 2: Add code to an existing file in your project (you provide the file path)
Option 3: Just show the code (no files created/modified)

Please select Option 1, 2, or 3."

⏸️ 等待用户明确选择后再继续。

步骤 2：根据参考文件生成代码

• 读取与所请求功能相关的 references/*.md 文件
• 仅使用参考文件中的代码片段编写 C# 和/或 XAML 代码
• 暂不展示代码，也暂不创建文件

步骤 3：处理用户选择

**选项 1：**展示代码 → 自动保存到 .codestudio/skills/wpf-spreadsheet-editor/output/（仅限技能文件夹） **选项 2：**询问文件路径 → 展示代码 → 等待用户明确回复 YES 确认 → 应用代码 → 询问是否构建 **选项 3：**展示代码、摘要和所需程序集 → 完成（不创建或修改文件）

• **仅适用于选项 2：**生成代码前，检查项目是否满足 references/getting-started.md（Prerequisites and Setup Requirements 部分）中的先决条件。如果缺少，请征求用户同意并添加。

---

不在范围内的请求

当用户提出的问题与技能领域不匹配（即与 WPF Spreadsheet、Excel 处理或 Syncfusion 电子表格控件无关）时，请回复：

“无法处理此输入。请换一种方式提供输入。”

请勿尝试：

• 生成电子表格/Excel 领域以外的代码
• 提供与电子表格功能无关的常规 WPF 指导
• 处理有关其他 Syncfusion 控件或无关框架的请求
• 协助处理与电子表格无关的功能

仅当用户的请求符合触发关键词时，才启用此技能及其工作流：“spreadsheet”、“Excel”、“UI”、“code”、“Ribbon”、“WPF”（需与电子表格/Excel 相关）。

代码参考

所有模板和功能片段都位于 references/*.md 中。每个文件都包含一个专门的片段，Agent 会在生成示例时组合这些片段。

流程：始终从 references/getting-started.md（先决条件和设置要求部分）开始，然后合并匹配的功能片段。如果没有匹配的功能关键词，则仅返回基本示例。

文件	内容
getting-started.md	程序集、XAML 设置、创建/打开/保存工作簿、从数据表导入和导出到数据表
localization.md	电子表格的本地化和语言支持
ribbon.md	内置功能区概述和集成
ribbon-customization.md	添加/移除功能区选项卡和项、取消功能区命令
worksheet-management.md	插入工作表/删除工作表/重命名工作表/隐藏工作表、网格线、标题、缩放、事件
editing-and-selection.md	单元格编辑、剪切/复制/粘贴、键盘交互
selection.md	单元格选择模式、选择区域、选择行/列
find-and-replace.md	查找全部、查找下一个、查找条件格式、查找常量、查找公式、查找数据验证、全部替换和替换操作
formulas.md	400 多个兼容 Excel 的公式、公式栏、多线程计算、名称区域
name-manager.md	创建、编辑和管理名称区域
cell-comments.md	创建、编辑和管理单元格评论和备注
cell-formatting.md	设置文本值、数字值、日期值、边框、字体、填充颜色、对齐方式、字体样式、自动换行、内置样式、套用表格格式、清除格式
resizing-and-hiding.md	插入/删除、隐藏/取消隐藏行和列、设置行高和列宽
sorting-and-filtering.md	排序和筛选数据、应用筛选器、自定义排序顺序、按值和条件筛选
conditional-formatting.md	数据条、图标集、色阶、基于规则的格式设置
data-validation.md	输入限制、错误警报、列表和跨工作表验证
freeze-panes.md	冻结行和列，便于导航和滚动
clipboard-operations.md	剪切、复制、粘贴及选择性粘贴选项
charts-pictures-textboxes.md	导入并显示图表、图像和文本框
outlines.md	分组/取消分组行和列、展开/折叠大纲级别
sparklines.md	导入折线、柱形和盈亏迷你图
merge-cells.md	合并和取消合并单元格
workbook-worksheet-protection.md	使用密码保护工作表和工作簿结构
conversion.md	导出为 PDF、HTML、图像和 CSV；打印电子表格
fill-series.md	使用序列值和模式自动填充单元格
floating-cells.md	使用浮动单元格和文本框
hyperlinks-and-bookmarks.md	创建和管理超链接和书签
supported-file-types.md	支持的文件格式和导入/导出选项
undo-redo.md	撤销和重做电子表格操作
zooming.md	放大/缩小并调整视图级别

---

规则

1. 仅使用参考代码片段

   • 生成代码时，只能使用 references/ 下的 Markdown 文件
   • 不得臆造、猜测或包含 references/*.md 中未出现的任何属性、事件、API 方法、组件名称或参数

2. 未经许可不得修改文件

   • 未经用户明确选择并确认，不得在用户工作区中创建或修改文件/文件夹。
   • 未经用户许可，不得创建 StackPanel、按钮、文本块、对话框、MessageBox 或 Spreadsheet 之外的任何 UI 元素。

3. 不支持的功能处理

   • 如果用户请求的功能在 references/*.md 中没有对应的代码片段，请回复： That feature is not currently supported by the Syncfusion WPF Spreadsheet component.
   • 仅在有对应代码片段时，建议最接近的受支持功能
   • 明确列出不受支持的项目，且不得为其生成代码

4. 写入前验证

   • 写入前重新验证所有代码块均来自 references/*.md 文件
   • 如果验证失败，请停止并告知用户