C#中使用NPOI进行Excel读写操作详解

一、NPOI简介

NPOI是.NET平台下操作Office文档的开源库,完全基于.NET Standard,无需安装Office组件。它支持读写Excel 97-2003 (.xls) 和 Excel 2007+ (.xlsx) 格式,并提供简单易用的API。适用于Windows、Linux、macOS等环境。

二、安装与引用

通过NuGet包管理器安装:

Install-Package NPOI

或在Visual Studio中右键项目 -> 管理NuGet程序包 -> 搜索NPOI并安装。

三、核心类型与命名空间

常用命名空间:

  • NPOI.HSSF.UserModel:用于操作.xls文件。
  • NPOI.XSSF.UserModel:用于操作.xlsx文件。

主要类:HSSFWorkbook、XSSFWorkbook、ISheet、IRow、ICell等。

四、写入Excel

创建一个包含数据的Excel文件:

using NPOI.HSSF.UserModel; // 或 XSSFUserModel
using NPOI.SS.UserModel;

// 创建工作簿
IWorkbook workbook = new HSSFWorkbook(); // 或 new XSSFWorkbook();
ISheet sheet = workbook.CreateSheet("Sheet1");

// 创建标题行
IRow headerRow = sheet.CreateRow(0);
headerRow.CreateCell(0).SetCellValue("姓名");
headerRow.CreateCell(1).SetCellValue("年龄");

// 创建数据行
IRow dataRow = sheet.CreateRow(1);
dataRow.CreateCell(0).SetCellValue("张三");
dataRow.CreateCell(1).SetCellValue(25);

// 写入文件
using (FileStream fs = new FileStream("test.xls", FileMode.Create))
{
workbook.Write(fs);
}

五、读取Excel

读取已有Excel文件:

using NPOI.HSSF.UserModel;
using NPOI.SS.UserModel;

using (FileStream fs = new FileStream("test.xls", FileMode.Open))
{
IWorkbook workbook = new HSSFWorkbook(fs);
ISheet sheet = workbook.GetSheetAt(0);

for (int rowIdx = 0; rowIdx <= sheet.LastRowNum; rowIdx++)
{
IRow row = sheet.GetRow(rowIdx);
if (row != null)
{
for (int colIdx = 0; colIdx < row.LastCellNum; colIdx++)
{
ICell cell = row.GetCell(colIdx);
switch (cell.CellType)
{
case CellType.String:
Console.Write(cell.StringCellValue + " ");
break;
case CellType.Numeric:
Console.Write(cell.NumericCellValue + " ");
break;
}
}
Console.WriteLine();
}
}
}

六、高级操作

1. 合并单元格

sheet.AddMergedRegion(new CellRangeAddress(0, 0, 0, 2)); // 合并第0行第0-2列

2. 设置单元格样式

ICellStyle style = workbook.CreateCellStyle();
style.FillForegroundColor = IndexedColors.Yellow.Index;
style.FillPattern = FillPattern.SolidForeground;
cell.CellStyle = style;

3. 公式计算

IRow row = sheet.CreateRow(0);
row.CreateCell(0).SetCellValue(100);
row.CreateCell(1).SetCellValue(200);
row.CreateCell(2).CellFormula = "A1+B1"; // 公式

七、注意事项

  • .xls与.xlsx使用不同工作簿类,注意选择正确类。
  • 读取时应检查CellType,避免类型转换异常。
  • 写入大量数据时,建议分批写入并适时刷新流。
  • NPOI对日期处理需使用CellType.Numeric并判断是否日期格式。

八、总结

NPOI是C#中操作Excel的首选库之一,功能全面且跨平台。通过上述示例,你可以快速实现基本的读写功能。实际项目中还可结合数据验证、图片插入等高级特性。希望本文对你有所帮助。