一、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清晰简单、易于扩展,可以满足各种定制化需求。