syncfusion-uwp-spreadsheet-editor

Syncfusion UWP 电子表格编辑器

概述

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

主要功能

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

快速入门示例

示例 1

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

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

示例 2

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

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

---

生成 UWP 代码 — 工作流

触发关键词：“how to”、“add spreadsheet”、“code sample”、“show me”、“example”、“snippet”、“integrate”、“component”、“create sample”、“code”、“sample code”、“generate code”、“implement”、“add to project”、“configure spreadsheet”

步骤 1：询问用户的交付选项

显示代码之前，先询问：

"How would you like me to provide the solution?

Option 1: Create a new file in skill folder (.codestudio/skills/syncfusion-uwp-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/syncfusion-uwp-spreadsheet-editor/output/（仅限技能文件夹） **选项 2：**询问文件路径 → 显示代码 → 等待用户明确确认 YES → 应用代码 → 询问是否构建 **选项 3：**显示代码，并附上摘要和所需程序集 → 完成（不创建／修改文件）

• **仅适用于选项 2：**生成代码之前，检查项目是否具备 references/gettingstarted.md（先决条件和设置要求部分）中列出的先决条件。如果缺少，请征得用户同意后再添加。

---

范围外请求

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

“无法处理此输入。请以其他方式提供输入。”

请勿尝试：

• 生成电子表格／Excel 领域之外的代码
• 提供与电子表格功能无关的一般 UWP 指导
• 处理有关其他 Syncfusion 控件或无关框架的请求
• 协助处理非电子表格功能

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

代码参考

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

流程：始终从 references/gettingstarted.md 开始（Prerequisites and Setup Requirements 部分），然后合并匹配的功能片段。如果没有匹配的功能关键词，则仅返回基本示例。

文件	内容
gettingstarted.md	检查 NuGet 包、XAML 设置、命名空间、创建/打开/保存工作簿、基本电子表格代码
localization.md	支持的语言、区域性设置、本地化 UI 字符串、RTL 支持、数字/日期/货币格式、动态切换语言
ribboncustomization.md	添加自定义功能区选项卡、向现有选项卡添加项目、移除功能区选项卡和项目、功能区自定义模式
worksheetmanagement.md	插入/删除/重命名/隐藏/取消隐藏工作表、保护（工作表和工作簿）、网格线、标题、缩放
editing.md	启用/禁用编辑、以编程方式编辑单元格、锁定/解锁单元格、编辑事件、数据验证（数字、日期、文本、列表、自定义公式）、超链接
selection.md	启用/禁用选择、访问当前单元格、获取所选范围、添加/清除选择、移动当前单元格、转换 GridRangeInfo 和 IRange、选择事件、键盘导航
findandreplace.md	查找全部、查找下一个、查找条件格式、查找常量、查找公式、查找数据验证、全部替换、替换操作
formulas.md	向单元格添加公式、409+ 个内置函数（数据库、日期/时间、数学、文本、逻辑、查找、统计、财务、信息）、命名范围、公式计算引擎
customformula.md	注册自定义公式、向 FormulaEngine 添加自定义公式、实现自定义公式逻辑、在单元格中使用自定义公式
formatting.md	单元格背景色、字体格式、单元格边框、单元格对齐、文本换行、合并/取消合并单元格、数字格式、内置样式、套用表格格式、清除格式
rowsandcolumns.md	插入/删除行和列、行高和列宽、隐藏/显示行和列、冻结/取消冻结窗格、自动调整行高和列宽
conditionalformatting.md	突出显示单元格规则（值、公式、文本、时间段）、数据条、色阶、图标集、比较运算符、格式类型、时间段类型
interactivefeatures.md	剪贴板操作（剪切、复制、粘贴、以编程方式设置粘贴选项）、撤消/重做功能、上下文菜单自定义、单元格批注
outline.md	分组/取消分组行和列、展开/折叠组、大纲设置、清除所有大纲
shapes.md	**⚠️ 图形元素必需：**图表（注册 GraphicChartCellRenderer）、迷你图（注册 SparklineCellRenderer）、图片（在运行时添加）、文本框、选择形状、清除形状选择
workingwithsfspreadsheet.md	访问工作簿/工作表、访问 SpreadsheetGrid、工作簿加载/卸载事件、设置活动工作表、访问单元格和范围、设置/清除单元格值、刷新视图、滚动、公式栏可见性、检查工作簿是否已修改、禁止显示警告、暂停/恢复公式计算、弹出窗口管理

---

规则

1. 仅使用参考代码片段

   • 生成的代码必须完全来自 references/ 下的 Markdown 文件
   • 不得虚构、猜测或包含 references/*.md 中不存在的任何属性、事件、API 方法、组件名称或参数

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

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

3. 不支持的功能处理方式

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

4. 写入前验证

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