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