C# NPOI操作Excel

一、NPOI简介

NPOI是一个在C#/.NET平台上使用的读写Excel2007及Excel 97-2003文件的开源组件。支持流和文件两种方式读取和写入。NPOI是一款基于.NET框架的组件，可以更方便地处理Excel文件。同时，NPOI还支持Word和PowerPoint文件的处理。

NPOI具有NPOI.HSSF、NPOI.XSSF、NPOI.HPSF和NPOI.POIFSFilesystem四个包。其中，NPOI.HSSF适用于操作Excel2003及Excel 97-2003文件，而NPOI.XSSF适用于操作Excel2007文件。NPOI.HPSF可以读取和写入Office Document Properties，而NPOI.POIFSFilesystem可用于操作OLE2 Compound Document文件格式。

NPOI是NHibernate的一部分，可以与NHibernate无缝集成。

二、NPOI的特点

NPOI是使用C#语言开发的，可以运行在Windows、Linux和Mac系统上。NPOI支持各种类型的数据源，包括特定存储库、XML文档和ADO数据源。NPOI的接口友好，易于使用。同时，NPOI还具有以下特点：

1、高效快速：NPOI使用基于流的方法，读写速度快，占用内存少。

2、灵活可扩展：NPOI的API清晰简单，易于扩展。可以通过继承和重载方式新增自定义功能。

3、功能丰富：NPOI能够实现Excel的大部分功能，包括单元格样式、合并单元格、保护工作表和单元格、数据校验等。

三、NPOI的安装

在C#项目中使用NPOI需要引入NPOI的dll文件。NPOI官方网站提供了两种获取方式：

1、从NPOI的官网上下载源代码后自行编译得到dll文件。

//引入命名空间
using NPOI.XSSF.UserModel;
using NPOI.SS.UserModel;
using System.IO;
//创建Excel文件
XSSFWorkbook wb = new XSSFWorkbook();
ISheet sheet = wb.CreateSheet("Sheet1");
IRow row = sheet.CreateRow(0);
row.CreateCell(0).SetCellValue("This is a test");
row.CreateCell(1).SetCellValue(4.5);
row.CreateCell(2).SetCellValue(true);
//将Excel文件保存到磁盘文件中
FileStream sw = File.Create("D:\\workbook.xlsx");
wb.Write(sw);
sw.Close();

2、使用NuGet包管理器来获取NPOI。

//安装NPOI
Install-Package NPOI -Version 2.4.1
//引入命名空间
using NPOI.XSSF.UserModel;
using NPOI.SS.UserModel;
using System.IO;
//创建Excel文件
XSSFWorkbook wb = new XSSFWorkbook();
ISheet sheet = wb.CreateSheet("Sheet1");
IRow row = sheet.CreateRow(0);
row.CreateCell(0).SetCellValue("This is a test");
row.CreateCell(1).SetCellValue(4.5);
row.CreateCell(2).SetCellValue(true);
//将Excel文件保存到磁盘文件中
FileStream sw = File.Create("D:\\workbook.xlsx");
wb.Write(sw);
sw.Close();

四、NPOI操作Excel

以下是一段基本的使用NPOI操作Excel的代码示例：

//引入命名空间
using NPOI.XSSF.UserModel;
using NPOI.SS.UserModel;
using System.IO;
//读取Excel文件
FileStream fs = new FileStream("D:\\workbook.xlsx", FileMode.Open, FileAccess.Read);
XSSFWorkbook wb = new XSSFWorkbook(fs);
ISheet sheet = wb.GetSheet("Sheet1");//获取Sheet1工作表
IRow row = sheet.GetRow(0);//获取第一行
string cellValue = row.GetCell(0).ToString();//获取第一行第一列单元格的值
//向Excel文件中写入数据
row.CreateCell(1).SetCellValue("Hello world");//在第一行第二列写入数据
FileStream sw = File.Open("D:\\workbook.xlsx", FileMode.Open, FileAccess.Write);
wb.Write(sw);//将Excel文件保存到磁盘文件中
sw.Close();

通过以上代码，我们可以实现Excel文件的读取和写入，并且可以操作Excel文件中的单元格、行和列。

五、NPOI操作Excel中的常用功能

1、设置单元格样式

NPOI支持多种样式的单元格，包括字体、颜色、边框、对齐方式等。以下是设置单元格样式的代码示例：

//引入命名空间
using NPOI.XSSF.UserModel;
using NPOI.SS.UserModel;
using System.IO;
//创建Excel文件
XSSFWorkbook wb = new XSSFWorkbook();
ISheet sheet = wb.CreateSheet("Sheet1");
IRow row = sheet.CreateRow(0);
ICellStyle style = wb.CreateCellStyle();//新建单元格样式
style.Alignment = HorizontalAlignment.Center;//设置水平居中
style.VerticalAlignment = VerticalAlignment.Center;//设置垂直居中
sheet.SetColumnWidth(0, 20 * 256);//设置第一列列宽
IRow row = sheet.CreateRow(0);
ICell cell = row.CreateCell(0);
cell.SetCellValue("This is a test");
cell.CellStyle = style;//设置单元格样式
//将Excel文件保存到磁盘文件中
FileStream sw = File.Create("D:\\workbook.xlsx");
wb.Write(sw);
sw.Close();

2、合并单元格

NPOI可以将单元格进行合并，合并后的单元格将占用合并区域内的所有单元格。以下是合并单元格的代码示例：

//引入命名空间
using NPOI.XSSF.UserModel;
using NPOI.SS.UserModel;
using System.IO;
//创建Excel文件
XSSFWorkbook wb = new XSSFWorkbook();
ISheet sheet = wb.CreateSheet("Sheet1");
IRow row = sheet.CreateRow(0);
ICellStyle style = wb.CreateCellStyle();//新建单元格样式
style.Alignment = HorizontalAlignment.Center;//设置水平居中
style.VerticalAlignment = VerticalAlignment.Center;//设置垂直居中
sheet.SetColumnWidth(0, 20 * 256);//设置第一列列宽
IRow row = sheet.CreateRow(0);
ICell cell = row.CreateCell(0);
cell.SetCellValue("合并单元格");
cell.CellStyle = style;//设置单元格样式
//合并单元格
sheet.AddMergedRegion(new CellRangeAddress(0, 4, 0, 4));//合并第一行到第五行，第一列到第五列的单元格
//将Excel文件保存到磁盘文件中
FileStream sw = File.Create("D:\\workbook.xlsx");
wb.Write(sw);
sw.Close();

3、保护工作表和单元格

NPOI可以保护工作表和单元格，以防止用户意外地修改数据。以下是保护工作表和单元格的代码示例：

//引入命名空间
using NPOI.XSSF.UserModel;
using NPOI.SS.UserModel;
using System.IO;
//创建Excel文件
XSSFWorkbook wb = new XSSFWorkbook();
ISheet sheet = wb.CreateSheet("Sheet1");
sheet.ProtectSheet("password");//保护工作表，设置密码为password
IRow row = sheet.CreateRow(0);
row.CreateCell(0).SetCellValue("This is a test");
//保护单元格
ICellStyle style = wb.CreateCellStyle();
style.IsLocked = true;
sheet.DefaultColumnStyle = style;//设置默认单元格样式
sheet.DefaultRowHeight = 500;//设置默认行高
sheet.LockFormatColumns = true;//锁定所有列
sheet.LockFormatRows = true;//锁定所有行
//将Excel文件保存到磁盘文件中
FileStream sw = File.Create("D:\\workbook.xlsx");
wb.Write(sw);
sw.Close();

4、数据校验

NPOI可以对单元格进行数据校验，以保证数据的正确性和完整性。以下是设置数据校验的代码示例：

//引入命名空间
using NPOI.XSSF.UserModel;
using NPOI.SS.UserModel;
using System.IO;
//创建Excel文件
XSSFWorkbook wb = new XSSFWorkbook();
ISheet sheet = wb.CreateSheet("Sheet1");
IRow row = sheet.CreateRow(0);
row.CreateCell(0).SetCellValue("Age：");
sheet.SetColumnWidth(0, 20 * 256);//设置第一列列宽
//数据校验
IDataValidationHelper validationHelper = sheet.GetDataValidationHelper();
IDataValidationConstraint constraint = validationHelper.CreateNumericConstraint(ComparisonOperator.GreaterThan, "0");//设置数据校验规则，数字必须大于0
CellRangeAddressList regions = new CellRangeAddressList(0, 0, 1, 1);//设置校验单元格范围
IDataValidation dataValidation = validationHelper.CreateValidation(constraint, regions);//创建数据校验对象
sheet.AddValidationData(dataValidation);//将校验对象应用到工作表
//将Excel文件保存到磁盘文件中
FileStream sw = File.Create("D:\\workbook.xlsx");
wb.Write(sw);
sw.Close();

六、总结

使用NPOI可以快速、方便地实现对Excel文件的读写操作。同时，NPOI还支持各种高级功能，如单元格样式、合并单元格、保护工作表和单元格、数据校验等。需要注意的是，在使用NPOI时需要引入相应的dll文件，并且API清晰简单、易于扩展，可以满足各种定制化需求。