FastExcel 快速Excel写入组件使用文档

FastExcel 是PCHMI内置的Excel快速写入工具。
核心特点：内存缓冲、延迟合并保存、原子写入防文件损坏、断电自动恢复临时文件、文件占用自动重试。
适合PLC上位机高频日志、生产记录持续追加写入Excel场景。
保存与资源释放由PCHMI内部自动完成，业务代码无需手动调用任何保存相关方法。

1、简单概念

• 文件路径：Excel完整路径，例 @"D:\DB\MYEXCEL.xlsx"；文件夹不存在组件会自动创建。
• Sheet工作表名：Excel工作表名称，例 "Sheet1"，不存在会自动新建工作表。
• 表头数组cells：表格第一行列标题，新建表格自动写入；表格已存在不会重复写表头。
• 单行values数组：要追加的一行内容，顺序和表头一一对应。
• 内存缓存：写入先存放在内存，内部定时自动合并保存，减少磁盘IO。
• 原子保存tmp临时文件：先写.tmp临时文件，完成后替换正式Excel，防止断电崩溃造成文件损坏。

2、API接口说明

3、最简单行写入示例（直接复制使用）

FastExcel.Insert(@"D:\DB\MYEXCEL.xlsx", "Sheet1", new string[] { "A", "B", "C" }, new string[] { "1", "2", "3" });

4、PLC高频日志追加示例

string[] header = new string[] { "时间", "工位号", "状态", "产量" };
FastExcel.Insert(@"D:\DB\生产日志.xlsx", "生产记录", header, new string[] { DateTime.Now.ToString("yyyy-MM-dd HH:mm:ss"), "01", "运行", "100" });

5、批量多行写入示例

using System.Collections.Generic;
string[] header = new string[] { "编号", "名称", "数值" };
List<string[]> rowList = new List<string[]>(){new string[]{"1","产品A","120"},new string[]{"2","产品B","230"},new string[]{"3","产品C","450"}};
FastExcel.Insert(@"D:\DB\批量数据.xlsx", "Sheet1", header, rowList);

6、重要注意事项