使用 NPOI 创建 Excel 工作簿

基础示例

以下示例演示如何使用 aardio 调用 NPOI 创建 Excel 工作簿并写入数据：

// 导入 NPOI 库
import NPOI;

// 创建 XSSF 工作簿对象（对应 .xlsx 格式）
var workbook = NPOI.XSSF.UserModel.XSSFWorkbook();

// 创建一个名为 "Sheet1" 的工作表
var sheet = workbook.CreateSheet("Sheet1");

// 创建 15 行数据，在 A 列填充数字 1-15
for(i=1;15;1){
    // 创建行和单元格，并设置单元格值
    // 注意：NPOI 中行号和列号从 0 开始计数
    sheet.CreateRow(i).CreateCell(0).SetCellValue(i); // 填充 A2, A3...A16
}

// 将工作簿保存为 "sample.xlsx" 文件
workbook.Write("/sample.xlsx");

关键点说明

1. 索引从 0 开始：

   • NPOI 中的行号和列号都是从 0 开始计数
   • 例如 CreateRow(1) 实际创建的是 Excel 中的第 2 行

2. 文件路径：

   • aardio 中使用单个斜杠 / 开头的路径表示应用程序根目录
   • 也可以使用完整路径如 C:\path\to\file.xlsx

3. 性能优化：

   • 批量操作时建议先创建所有行和单元格，最后再设置值
   • 避免频繁调用 Write 方法，最好一次性写入

4. 异常处理：

   • 建议使用 try...catch 捕获可能的 IO 异常
   • 例如文件被占用或权限不足等情况

扩展功能

NPOI 还支持：

• 读取现有 Excel 文件
• 设置单元格样式和格式
• 创建图表和数据验证
• 处理公式和函数
• 更多高级功能...

Markdown 格式