NPOI 是 POI 项目的 .NET 版本。POI是一个开源的Java读写Excel、WORD等微软OLE2组件文档的项目。
简介
使用 NPOI 你就可以在没有安装 Office 或者相应环境的机器上对 WORD/EXCEL 文档进行读写。 NPOI是构建在 POI 3.x版本之上的，它可以在没有安装 Office的情况下对 Word/Excel文档进行读写操作。 [1]
优势
（一）传统操作 Excel遇到的问题：
1、如果是 .NET，需要在服务器端装 Office，且及时更新它，以防漏洞，还需要设定权限允许 .NET访问 COM+，如果在导出过程中出问题可能导致服务器宕机。
2、 Excel会把只包含数字的列进行类型转换，本来是文本型的， Excel会将其转成数值型的，比如编号000123会变成123。
3、导出时，如果字段内容以“-”或“=”开头，Excel会把它当成公式进行，会报错。
4、 Excel会根据 Excel文件前8行分析数据类型，如果正好你前8行某一列只是数字，那它会认为该列为数值型，自动将该列转变成类似1.42702 E+17格式，日期列变成包含日期和数字的。
（二）使用 NPOI的优势
1、您可以完全免费使用该框架
2、包含了大部分EXCEL的特性(单元格样式、数据格式、公式等等)
3、专业的技术支持服务(24*7全天候) (非免费)
4、支持处理的文件格式包括 , , .
5、采用面向接口的设计架构( 可以查看 NPOI.SS 的 )
6、同时支持文件的导入和导出
7、基于.net 2.0 也支持xlsx 和 docx格式(当然也支持.net 4.0)
8、来自全世界大量成功且真实的测试Cases
9、大量的实例代码
11、你不需要在服务器上安装微软的 Office，可以避免版权问题。
12、使用起来比 Office PIA的 API更加方便，更人性化。
13、你不用去花大力气维护 NPOI， NPOI Team会不断更新、改善 NPOI，绝对省成本。
NPOI之所以强大，并不是因为它支持导出 Excel，而是因为它支持导入 Excel，并能“理解” OLE2文 档结构，这也是其他一些Excel读写库比较弱的方面。通常，读入并理解结构远比导出来得复杂，因为导入你必须假设一切情况都是可能的，而生成你只要保证 满足你自己需求就可以了，如果把导入需求和生成需求比做两个集合，那么生成需求通常都是导入需求的子集，这一规律不仅体现在 Excel读写库中，也体现在 pdf读写库中，目前市面上大部分的 pdf库仅支持生成，不支持导入。
构成
NPOI 1.2.x主要由 POIFS、DDF、HPSF、HSSF、SS、Util六部分组成。
| NPOI.POIFS | OLE2/ActiveX文档属性读写库 |
| NPOI.DDF | Microsoft Office Drawing读写库 |
| NPOI.HPSF | OLE2/ActiveX文档读写库 |
| NPOI.HSSF | Microsoft Excel BIFF(Excel 97-2003)格式读写库 |
| NPOI.SS | Excel公用接口及Excel公式计算引擎 |
| NPOI.Util | 基础类库，提供了很多实用功能，可用于其他读写文件格式项目的开发 |
表1 NPOI组成部分
NPOI 1.x的最新版为NPOI 1.2.5，其中包括了以下功能：
1、读写 OLE2文档
2、读写 DocummentSummaryInformation和 SummaryInformation
3、基于 LittleEndian的字节读写
4、读写 Excel BIFF格式
5、识别并读写 Excel BIFF中的常见 Record，如RowRecord, StyleRecord, ExtendedFormatRecord
6、支持设置单元格的高、宽、样式等
7、支持调用部分 Excel内建函数，比如说 sum, countif以及计算符号
8、支持在生成的 XLS内嵌入打印设置，比如说横向/纵向打印、缩放、使用的纸张等。
NPOI 2.0主要由SS, HPSF, DDF, HSSF, XWPF, XSSF, OpenXml4Net, OpenXmlFormats组成，具体列表如下：
| Assembly名称 | 模块/命名空间 | 说明 |
| NPOI.DLL | NPOI.POIFS | OLE2/ActiveX文档属性读写库 |
| NPOI.DLL | NPOI.DDF | 微软Office Drawing读写库 |
| NPOI.DLL | NPOI.HPSF | OLE2/ActiveX文档读写库 |
| NPOI.DLL | NPOI.HSSF | 微软Excel BIFF(Excel 97-2003, doc)格式读写库 |
| NPOI.DLL | NPOI.SS | Excel公用接口及Excel公式计算引擎 |
| NPOI.DLL | NPOI.Util | 基础类库，提供了很多实用功能，可用于其他读写文件格式项目的开发 |
| NPOI.OOXML.DLL | NPOI.XSSF | Excel 2007(xlsx)格式读写库 |
| NPOI.OOXML.DLL | NPOI.XWPF | Word 2007(docx)格式读写库 |
| NPOI.OpenXml4Net.DLL | NPOI.OpenXml4Net | OpenXml底层zip包读写库 |
| NPOI.OpenXmlFormats.DLL | NPOI.OpenXmlFormats | 微软Office OpenXml对象关系库 |
项目近况：
在2013年10月8日，NPOI 2.0 beta 1发布，并已经支持Excel 2007和Word 2007。
系统要求：
VS2012/VS2010，基于.NET 4.0或者.NET 2.0 VS2005/VS2008，基于.NET 2.0 (SP1) VS2003，基于.NET 1.1 （仅更新到1.2.1版本，之后不再支持.NET 1.1） medium trust environment in ASP.NET
NPOI作为国人开发的开源项目，文档完善，更新及时，为. NET开发者提供了便利，主要用于生成 Excel报表，搜索引擎模块中 Excel中的文本提取，批量生成 Excel文件，基于 Excel文件模板生成新的 Excel等多方面。
Npoi 简介
1.整个Excel表格叫做工作表：WorkBook（工作薄），包含的叫页（工作表）：Sheet；行：Row；单元格Cell。
2.Npoi 下载地址：
3.Npoi 学习系列教程推荐：
4.忘了告诉大家npoi是做什么的了，npoi 能够读写几乎所有的Office 97-2003文件格式，至少能够支持Word, PowerPoint, Excel, Visio的格式。
使用Npoi创建一个简单的xls文件
//创建xls文件 private void button1_Click(object sender, EventArgs e) { //创建工作薄 HSSFWorkbook wk = new HSSFWorkbook(); //创建一个名称为mySheet的表 ISheet tb = wk.CreateSheet("mySheet"); //创建一行，此行为第二行 IRow row = tb.CreateRow(1); for (int i = 0; i < 20; i++) { ICell cell = row.CreateCell(i); //在第二行中创建单元格 cell.SetCellValue(i);//循环往第二行的单元格中添加数据 } using (FileStream fs = File.OpenWrite(@"c:/myxls.xls")) //打开一个xls文件，如果没有则自行创建，如果存在myxls.xls文件则在创建是不要打开该文件！ { wk.Write(fs); //向打开的这个xls文件中写入mySheet表并保存。 MessageBox.Show("提示：创建成功！"); } } 使用Npoi读取一个简单的xls文件
//读取xls文件 private void button2_Click(object sender, EventArgs e) { StringBuilder sbr = new StringBuilder(); using (FileStream fs = File.OpenRead(@"c:/myxls.xls")) //打开myxls.xls文件 { HSSFWorkbook wk = new HSSFWorkbook(fs); //把xls文件中的数据写入wk中 for (int i = 0; i < wk.NumberOfSheets; i++) //NumberOfSheets是myxls.xls中总共的表数 { ISheet sheet = wk.GetSheetAt(i); //读取当前表数据 for (int j = 0; j <= sheet.LastRowNum; j++) //LastRowNum 是当前表的总行数 { IRow row = sheet.GetRow(j); //读取当前行数据 if (row != null) { sbr.Append("-------------------------------------\r\n"); //读取行与行之间的提示界限 for (int k = 0; k <= row.LastCellNum; k++) //LastCellNum 是当前行的总列数 { ICell cell = row.GetCell(k); //当前表格 if (cell != null) { sbr.Append(cell.ToString()); //获取表格中的数据并转换为字符串类型 } } } } } } sbr.ToString(); using (StreamWriter wr = new StreamWriter(new FileStream(@"c:/myText.txt", FileMode.Append))) //把读取xls文件的数据写入myText.txt文件中 { wr.Write(sbr.ToString()); wr.Flush(); } } 使用Npoi创建一个常用的xls文件
//创建一个常用的xls文件 private void button3_Click(object sender, EventArgs e) { IWorkbook wb = new HSSFWorkbook(); //创建表 ISheet sh = wb.CreateSheet("zhiyuan"); //设置单元的宽度 sh.SetColumnWidth(0, 15 * 256); sh.SetColumnWidth(1, 35 * 256); sh.SetColumnWidth(2, 15 * 256); sh.SetColumnWidth(3, 10 * 256); int i = 0; #region 练习合并单元格 sh.AddMergedRegion(new NPOI.SS.Util.CellRangeAddress(0, 0, 0, 3)); //CellRangeAddress（）该方法的参数次序是：开始行号，结束行号，开始列号，结束列号。 IRow row0 = sh.CreateRow(0); row0.Height = 20 * 20; ICell icell1top0 = row0.CreateCell(0); icell1top0.CellStyle = Getcellstyle(wb, stylexls.头); icell1top0.SetCellValue("标题合并单元"); #endregion i++; #region 设置表头 IRow row1 = sh.CreateRow(1); row1.Height = 20 * 20; ICell icell1top = row1.CreateCell(0); icell1top.CellStyle = Getcellstyle(wb, stylexls.头); icell1top.SetCellValue("网站名"); ICell icell2top = row1.CreateCell(1); icell2top.CellStyle = Getcellstyle(wb, stylexls.头); icell2top.SetCellValue("网址"); ICell icell3top = row1.CreateCell(2); icell3top.CellStyle = Getcellstyle(wb, stylexls.头); icell3top.SetCellValue("百度快照"); ICell icell4top = row1.CreateCell(3); icell4top.CellStyle = Getcellstyle(wb, stylexls.头); icell4top.SetCellValue("百度收录"); #endregion using(FileStream stm=File.OpenWrite(@"c:/myMergeCell.xls")) { wb.Write(stm); MessageBox.Show("提示：创建成功！"); } } #region 定义单元格常用到样式的枚举 public enum stylexls { 头, url, 时间, 数字, 钱, 百分比, 中文大写, 科学计数法, 默认 } #endregion #region 定义单元格常用到样式 static ICellStyle Getcellstyle(IWorkbook wb, stylexls str) { ICellStyle cellStyle = wb.CreateCellStyle(); //定义几种字体 //也可以一种字体，写一些公共属性，然后在下面需要时加特殊的 IFont font12 = wb.CreateFont(); font12.FontHeightInPoints = 10; font12.FontName = "微软雅黑"; IFont font = wb.CreateFont(); font.FontName = "微软雅黑"; //font.Underline = 1;下划线 IFont fontcolorblue = wb.CreateFont(); fontcolorblue.Color = HSSFColor.OLIVE_GREEN.BLUE.index; fontcolorblue.IsItalic = true;//下划线 fontcolorblue.FontName = "微软雅黑"; //边框 cellStyle.BorderBottom = NPOI.SS.UserModel.BorderStyle.DOTTED; cellStyle.BorderLeft = NPOI.SS.UserModel.BorderStyle.HAIR; cellStyle.BorderRight = NPOI.SS.UserModel.BorderStyle.HAIR; cellStyle.BorderTop = NPOI.SS.UserModel.BorderStyle.DOTTED; //边框颜色 cellStyle.BottomBorderColor = HSSFColor.OLIVE_GREEN.BLUE.index; cellStyle.TopBorderColor = HSSFColor.OLIVE_GREEN.BLUE.index; //背景图形，我没有用到过。感觉很丑 //cellStyle.FillBackgroundColor = HSSFColor.OLIVE_GREEN.BLUE.index; //cellStyle.FillForegroundColor = HSSFColor.OLIVE_GREEN.BLUE.index; cellStyle.FillForegroundColor = HSSFColor.WHITE.index; // cellStyle.FillPattern = FillPatternType.NO_FILL; cellStyle.FillBackgroundColor = HSSFColor.BLUE.index; //水平对齐 cellStyle.Alignment = NPOI.SS.UserModel.HorizontalAlignment.LEFT; //垂直对齐 cellStyle.VerticalAlignment = VerticalAlignment.CENTER; //自动换行 cellStyle.WrapText = true; //缩进;当设置为1时，前面留的空白太大了。希旺官网改进。或者是我设置的不对 cellStyle.Indention = 0; //上面基本都是设共公的设置 //下面列出了常用的字段类型 switch (str) { case stylexls.头: // cellStyle.FillPattern = FillPatternType.LEAST_DOTS; cellStyle.SetFont(font12); break; case stylexls.时间: IDataFormat datastyle = wb.CreateDataFormat(); cellStyle.DataFormat = datastyle.GetFormat("yyyy/mm/dd"); cellStyle.SetFont(font); break; case stylexls.数字: cellStyle.DataFormat = HSSFDataFormat.GetBuiltinFormat("0.00"); cellStyle.SetFont(font); break; case stylexls.钱: IDataFormat format = wb.CreateDataFormat(); cellStyle.DataFormat = format.GetFormat("￥#,##0"); cellStyle.SetFont(font); break; case stylexls.url: fontcolorblue.Underline = 1; cellStyle.SetFont(fontcolorblue); break; case stylexls.百分比: cellStyle.DataFormat = HSSFDataFormat.GetBuiltinFormat("0.00%"); cellStyle.SetFont(font); break; case stylexls.中文大写: IDataFormat format1 = wb.CreateDataFormat(); cellStyle.DataFormat = format1.GetFormat("[DbNum2][$-804]0"); cellStyle.SetFont(font); break; case stylexls.科学计数法: cellStyle.DataFormat = HSSFDataFormat.GetBuiltinFormat("0.00E+00"); cellStyle.SetFont(font); break; case stylexls.默认: cellStyle.SetFont(font); break; } return cellStyle; } #endregion
提示：1.以上使用npoi版本为1.2.5版本，版本目前属于最高版本，跟以前版本的使用是有些差别的。
2.使用以上代码，需要添加两个npoi的dll。Ionic.Zip.dll，NPOI.dll
错误提示：The supplied data appears to be in the Office 2007+ XML. You are calling the part of POI that deals with OLE2 Office Documents. You need to call a different part of POI to process this data (eg XSSF instead of HSSF)
错误原因：
- HSSFWorkbook:是操作Excel2003以前（包括2003）的版本，扩展名是.xls
- XSSFWorkbook:是操作Excel2007的版本，扩展名是.xlsx
解决方案：（引用npoi2.0）
ISheet sheet; FileStream fs = null; try { fs = new FileStream(txtPath.Text, FileMode.Open, FileAccess.Read); HSSFWorkbook wk = new HSSFWorkbook(fs); sheet = wk.GetSheet(sheetName); } catch { fs = new FileStream(txtPath.Text, FileMode.Open, FileAccess.Read); XSSFWorkbook wk = new XSSFWorkbook(fs); sheet = wk.GetSheet(sheetName); } finally { fs.Close(); fs.Dispose(); } if (sheet.LastRowNum < 1) { MessageBox.Show("表内容不能为空"); return; } for (int j = 1; j <= sheet.LastRowNum; j++)