C#怎么操作Excel文件 C#使用NPOI库读写Excel表格的方法

来源:这里教程网 时间:2026-02-21 17:30:58 作者:

C#操作Excel文件常用的方式是使用NPOI库,它是一个开源的.NET库,可以读写Microsoft Office格式文件,包括Excel(.xls和.xlsx)。相比Office Interop,NPOI无需安装Excel软件,性能更好,适合在服务器端处理表格数据。

1. 安装NPOI库

在项目中使用NuGet包管理器安装NPOI:

Install-Package NPOI

支持 .NET Framework 和 .NET Core/.NET 5+ 项目。

2. 使用NPOI读取Excel文件

以下代码演示如何读取一个Excel文件中的数据:

示例:读取第一个工作表的所有单元格内容

using NPOI.SS.UserModel;
using NPOI.XSSF.UserModel;
using System.IO;

string filePath = "test.xlsx";
using (FileStream fs = new FileStream(filePath, FileMode.Open, FileAccess.Read))
{
   IWorkbook workbook = new XSSFWorkbook(fs); // .xlsx 文件
   ISheet sheet = workbook.GetSheetAt(0); // 获取第一个工作表

   for (int i = sheet.FirstRowNum; i    {
      IRow row = sheet.GetRow(i);
      if (row == null) continue;

      for (int j = row.FirstCellNum; j       {
         ICell cell = row.GetCell(j);
         if (cell != null)
            Console.Write(GetCellValue(cell) + "\t");
      }
      Console.WriteLine();
   }
}

// 辅助方法:获取单元格实际值
static string GetCellValue(ICell cell)
{
   return cell.CellType switch
   {
      CellType.String => cell.StringCellValue,
      CellType.Numeric => cell.NumericCellValue.ToString(),
      CellType.Boolean => cell.BooleanCellValue.ToString(),
      CellType.Formula => cell.CellFormula,
      _ => ""
   };
}

3. 使用NPOI写入Excel文件

创建一个新的Excel文件并写入数据:

using NPOI.XSSF.UserModel;
using NPOI.SS.UserModel;
using System.IO;

using (IWorkbook workbook = new XSSFWorkbook())
{
   ISheet sheet = workbook.CreateSheet("Sheet1");

   // 创建第一行
   IRow headerRow = sheet.CreateRow(0);
   headerRow.CreateCell(0).SetCellValue("姓名");
   headerRow.CreateCell(1).SetCellValue("年龄");
   headerRow.CreateCell(2).SetCellValue("城市");

   // 添加数据行
   IRow dataRow = sheet.CreateRow(1);
   dataRow.CreateCell(0).SetCellValue("张三");
   dataRow.CreateCell(1).SetCellValue(28);
   dataRow.CreateCell(2).SetCellValue("北京");

   // 保存到文件
   using (FileStream fs = new FileStream("output.xlsx", FileMode.Create, FileAccess.Write))
   {
      workbook.Write(fs);
   }
}
Console.WriteLine("Excel文件已生成。");

4. 注意事项与常见问题

区分.xls和.xlsx格式:
- .xlsx(Excel 2007+)使用 XSSFWorkbook
- .xls(旧版)使用 HSSFWorkbook

文件流必须正确释放:
使用 using 语句确保 FileStream 和 Workbook 被及时释放,避免文件被占用。

处理合并单元格:
可通过 sheet.NumMergedRegions 和 sheet.GetMergedRegion() 获取合并区域信息。

设置单元格样式(可选):
NPOI支持字体、颜色、对齐方式等样式设置,通过 ICellStyle 实现。

基本上就这些。NPOI功能强大,适合大多数Excel导入导出场景,比如从Excel批量导入数据到数据库,或导出报表。掌握基本读写后,可进一步探索公式、图表、图片等高级功能。不复杂但容易忽略细节,比如单元格类型判断和流的管理。

相关推荐