文档与办公 · SKILL.md

reogrid

reogrid

【文档与办公】Use when embedding an Excel-like spreadsheet control in .NET WinForms/WPF applications — formula engine, cell editing, clipboard, undo/redo. ReoGrid: .NET spreadsheet component with NPOI-based Excel read/write.

独立 GitHub 快照 · 自动分类 · 以原作者文档为准

Zznlgis / opengis-skillsMIT

技能说明

GitHub

name: reogrid description: "Use when embedding an Excel-like spreadsheet control in .NET WinForms/WPF applications — formula engine, cell editing, clipboard, undo/redo. ReoGrid: .NET spreadsheet component with NPOI-based Excel read/write." tags:

dotnet
spreadsheet
winforms
wpf
excel

项目地址： https://github.com/unvell/ReoGrid

官网： https://reogrid.net/

NuGet： unvell.ReoGrid.dll（WinForms 核心）、unvell.ReoGridWPF.dll（WPF）、unvell.ReoGrid8.dll（.NET 8 版）

最新版本： unvell.ReoGrid.dll 3.3.1 / unvell.ReoGridWPF.dll 3.3.0 / unvell.ReoGrid8.dll 8.1.0（截至2026-09，NuGet）

许可证： MIT（V3 社区版）；商业版另购（V4）

概述

ReoGrid 主要能力：

WinForms 与 WPF 双控件
单元格：样式、字体、边框、对齐、数据格式
合并单元格、冻结、批注
公式：内置 ~ 100 个 Excel 函数
数据验证、自动筛选、排序
图表：内置基础图表（柱状/折线/饼图）
打印与导出（PDF/CSV）
Excel 互通：读写 .xlsx / .xls（依赖 NPOI）
脚本扩展：内嵌 JS 脚本（基于 ReoScript）

ReoGrid 不依赖 Excel/COM，纯托管代码，跨 .NET Framework 与 .NET 6+。

安装

# WinForms
dotnet add package unvell.ReoGrid.dll

# WPF
dotnet add package unvell.ReoGridWPF.dll

# .NET 8 版本（WinForms 核心）
dotnet add package unvell.ReoGrid8.dll

三个包内的程序集名均为 unvell.ReoGrid.dll，命名空间统一是 unvell.ReoGrid.*。

WinForms 入门

using unvell.ReoGrid;
using unvell.ReoGrid.IO;

var grid = new ReoGridControl { Dock = DockStyle.Fill };
this.Controls.Add(grid);

var sheet = grid.CurrentWorksheet;
sheet["A1"] = "ID";
sheet["B1"] = "Name";
sheet["C1"] = "Score";

sheet["A2"] = 1;
sheet["B2"] = "Tom";
sheet["C2"] = 95;

WPF 入门

<Window xmlns:rg="clr-namespace:unvell.ReoGrid;assembly=unvell.ReoGrid">
  <rg:ReoGridControl x:Name="Grid"/>
</Window>

var sh = Grid.CurrentWorksheet;
sh["A1:C1"] = new object[] { "ID", "Name", "Score" };
sh["A2:C2"] = new object[] { 1, "Tom", 95 };

区域操作

sh.SetRangeData("A2:C4", new object[,] {
    { 1, "Tom",  95 },
    { 2, "Lucy", 88 },
    { 3, "Mike", 72 },
});

object[,] data = (object[,])sh.GetRangeData("A2:C4");

样式

sh.SetRangeStyles("A1:C1", new WorksheetRangeStyle {
    Flag = PlainStyleFlag.All,
    Bold = true,
    BackColor = Color.LightGray,
    HorizontalAlign = ReoGridHorAlign.Center,
    VerticalAlign   = ReoGridVerAlign.Middle,
    TextColor = Color.Black,
    FontSize = 12
});

// 数据格式（百分比 / 日期）
sh.SetRangeDataFormat("C2:C100", CellDataFormatFlag.Percent,
    new NumberDataFormatter.NumberFormatArgs { DecimalPlaces = 2 });

sh.SetRangeDataFormat("D2:D100", CellDataFormatFlag.DateTime,
    new DateTimeDataFormatter.DateTimeFormatArgs { Format = "yyyy-MM-dd" });

公式

sh["C5"] = "=SUM(C2:C4)";
sh["C6"] = "=AVERAGE(C2:C4)";
sh["C7"] = "=IF(C2>90, \"A\", \"B\")";

sh.Recalculate();   // 强制重算

合并 / 冻结 / 批注

sh.MergeRange("A1:C1");
sh.FreezeToCell("A2");

sh.Cells["B2"].Comment = new Comment("张三是优秀员工");

数据验证

sh.AddRangeDataValidation(new DataValidation(
    new RangePosition("C2:C100"),
    DataValidationType.WholeNumber, 0, 100));

自动筛选

sh.CreateAutoFilter("A1:C100");

Excel 文件读写

grid.Load("input.xlsx", FileFormat.Excel2007);
grid.Save("output.xlsx", FileFormat.Excel2007);
grid.Save("data.csv", FileFormat.CSV);

事件

sh.CellDataChanged += (s, e) =>
    Debug.WriteLine(quot;{e.Cell.PositionAsString} 改为 {e.Cell.Data}");

sh.SelectionChanged += (s, e) => statusLabel.Text = e.Range.ToAddress();

图表

using unvell.ReoGrid.Drawing;
using unvell.ReoGrid.Chart;

var chart = new LineChart {
    Bounds = new Rectangle(300, 50, 400, 300),
    Title = "成绩",
    DataSource = new WorksheetChartDataSource(sh, "B1:B4", "C2:C4")
};
sh.FloatingObjects.Add(chart);

脚本（ReoScript）

// 内嵌 JS
function autoFill(sheet) {
    for (var i = 1; i < 10; i++) {
        sheet["A" + (i+1)] = i;
        sheet["B" + (i+1)] = i * 100;
    }
}

grid.RunScript(@"autoFill(workbook.currentWorksheet);");

打印 / 导出 PDF

grid.Worksheets[0].PrintSettings = new PrintSettings {
    PageOrientation = PageOrientation.Landscape,
    Margins = new PageMargins(0.5f, 0.5f, 0.5f, 0.5f)
};
grid.Print();      // 调用打印对话框

grid.Save("report.pdf", FileFormat.PDF);

性能优化

大量写入用 SetRangeData(...) 替代逐格赋值
改动期间禁用刷新：sh.SuspendUIUpdates() / sh.ResumeUIUpdates()
数千公式时减少 Recalculate，由用户触发
大文件读写依赖 NPOI，注意内存
行/列上限：1,048,576 行 × 32,768 列（与 Excel 接近）

典型工作流

场景一：在 WinForms 应用中嵌入数据报表

// 1. 创建控件并加载数据
var grid = new ReoGridControl { Dock = DockStyle.Fill };
this.Controls.Add(grid);
var sheet = grid.CurrentWorksheet;

// 2. 设置标题行样式
sheet.SetRangeStyles("A1:D1", new WorksheetRangeStyle {
    Flag = PlainStyleFlag.All,
    Bold = true,
    BackColor = Color.LightGray,
    HorizontalAlign = ReoGridHorAlign.Center,
});

// 3. 批量填充数据
sheet["A1:D1"] = new object[] { "ID", "姓名", "部门", "薪资" };
sheet.SetRangeData("A2:D100", dataArray);   // 大批量用 SetRangeData

// 4. 添加汇总公式
sheet["D101"] = "=SUM(D2:D100)";
sheet["A101"] = "合计：";
sheet.MergeRange("A101:C101");

// 5. 冻结标题行 + 自动筛选
sheet.FreezeToCell("A2");
sheet.CreateAutoFilter("A1:D100");

// 6. 导出
grid.Save("report.xlsx", FileFormat.Excel2007);

场景二：构建交互式数据录入表格

// 1. 创建带验证的模板
sheet["A1:C1"] = new object[] { "日期", "项目", "金额" };
sheet.SetRangeStyles("A1:C1", new WorksheetRangeStyle { Bold = true });

// 2. 设置日期列格式
sheet.SetRangeDataFormat("A2:A100", CellDataFormatFlag.DateTime,
    new DateTimeDataFormatter.DateTimeFormatArgs { Format = "yyyy-MM-dd" });

// 3. 金额列添加数据验证（0-100000）
sheet.AddRangeDataValidation(new DataValidation(
    new RangePosition("C2:C100"),
    DataValidationType.Decimal, 0, 100000));

// 4. 监听数据变更做实时计算
sheet.CellDataChanged += (s, e) => {
    if (e.Cell.Column == 2)  // C 列变更时重算合计
        sheet["C101"] = "=SUM(C2:C100)";
};

// 5. 提供保存按钮
btnSave.Click += (s, e) => grid.Save("data.xlsx", FileFormat.Excel2007);

AI 使用建议

关键模式与常见陷阱

批量赋值优先：逐格赋值 (sheet["A1"] = val) 在千行以上会很慢，必须改用 SetRangeData()
UI 更新暂停：大量数据填充期间务必 SuspendUIUpdates() / ResumeUIUpdates()
公式不会自动触发：设置了公式后需要调用 Recalculate()，或在 CellDataChanged 事件中手动触发
样式限制：ReoGrid 仅支持核心 Excel 样式，复杂条件格式/图表建议直接用 NPOI 生成后导入
商业授权：V3社区版为MIT许可，商业闭源产品需购买V4商业许可
DPI 适配：WPF 高 DPI 环境需启用 PerMonitorV2，否则控件模糊

如何选择正确方案

场景	推荐方案
简单数据展示/导出	直接用 NPOI，无需 ReoGrid
WinForms/WPF 内嵌可编辑表格	ReoGrid
纯 Excel 文件处理（无 UI）	NPOI
复杂图表/数据透视表	商业控件（Spread.NET / Aspose.Cells）

常见问题

问题	解决
V3社区版功能有限（如缺少部分高级功能），商业闭源建议购买V4商业许可	购买 V4 商业许可获取完整功能
WPF 高 DPI 模糊	启用 `PerMonitorV2` DPI
公式不计算	调用 `sh.Recalculate()`
Excel 打开样式丢失	仅支持核心样式，复杂样式建议直接 NPOI 处理

参考资源

官网：https://reogrid.net/
仓库：https://github.com/unvell/ReoGrid
中文教程（znlgis）：https://znlgis.github.io/csharp/ReoGrid/

MAKE IT PART OF YOUR WORKFLOW

安装技能

TERMINAL

npx skills add znlgis/opengis-skills --skill reogrid

复制命令到本地终端执行；安装前请先审查源代码和许可证。

ZIP · 完整技能目录，含资源与许可证

SKILL.md · 仅技能说明原文

仓库 Star: 未同步
许可证: MIT
版本 / 分支: HEAD · c721cedc
仓库更新时间: 未同步

安装前，请检查技能脚本与权限。

源代码

reogrid

技能说明

概述

安装

WinForms 入门

WPF 入门

区域操作

样式

公式

合并 / 冻结 / 批注

数据验证

自动筛选

Excel 文件读写

事件

图表

脚本（ReoScript）

打印 / 导出 PDF

性能优化

典型工作流

场景一：在 WinForms 应用中嵌入数据报表

场景二：构建交互式数据录入表格

AI 使用建议

推荐工作流

关键模式与常见陷阱

如何选择正确方案

常见问题

相关技能

参考资源

reogrid

技能说明

概述

安装

WinForms 入门

WPF 入门

区域操作

样式

公式

合并 / 冻结 / 批注

数据验证

自动筛选

Excel 文件读写

事件

图表

脚本（ReoScript）

打印 / 导出 PDF

性能优化

典型工作流

场景一：在 WinForms 应用中嵌入数据报表

场景二：构建交互式数据录入表格

AI 使用建议

推荐工作流

关键模式与常见陷阱

如何选择正确方案

常见问题

相关技能

参考资源

发现更多相关技能

视觉画布设计

Word 文档处理

PDF 文档处理