Npoi 使用总结 回顾 反思

好几天没有写博客了，突然间有种写博客的冲动，虽然我的技术能力还是在努力的进步，但是和那些大牛比起来，我确实是小菜一枚，不过这并没有打击我的积极性，反而让我有种冲动，去超越他们。哈哈

我记得在几天前我说过一个Lucene.net，是从java中借鉴过来的，现在我来说一下Npoi吧，当然这个也是从java借鉴过来的，不过这个语法没有Lucene.net那么恶心，Lucene.net是完全的java版，但是npoi.net最起码有点和.net联系在了一起。好东西都是java的，.net大牛们，你们在干嘛，开发一些优秀的东西吧，别总让java鄙视我们。

好了，说说Npoi.net吧，Npoi是对Excel(或者叫office比较合适)进行操作的一个类库框架，我们可以不再使用office提供的那个恶心的接口（速度慢）来操作了，我们对于office的操作解放了。现在最新版的应该是1.2.5.如果你安装了NuGet的话，可以很容易的获取。

因为Excel 2003极其以前的版本采用的底层代码和Excel 2007 及其以后的不同，所以对于这个分界点是需要我们注意的。为什么会出现这个分界点，大家想一下，现在微软的所有东西都在.net 架构之下，以前的Excel版本和这个架构肯定是不同的。

我们重点来说excel。毕竟这是在我们的工作中用的最多的一个，Excel包括文件(file，在Npoi.net中称为workBook 工作簿)、工作表(sheet)以及里面的单元格，按照从大到小的分类就是文件中包含若干个sheet，每个sheet中包含很多单元格。这是Excel的分类。

为了操作Excel，npoi.net当然也需要对应的类来对应不同的分类，其中

HSSFWorkbook对应的就是Excel文件 工作簿，

HSSFSheet对应的就是Excel中sheet 工作表，

HSSFCell对应的就是Excel的单元格，

HSSFRow对应的就是Excel的行。

有了这几个不同的类，我们就可以创建Excel文件，创建sheet，给sheet重命名或删除sheet，创建行，添加单元格，为单元格设置格式，我个人感觉其他的都很简单，唯独这个给单元格设置格式的做法很令人讨厌，没办法用的别人的，只能有苦自己承受了。

下面我就举一个很简单的例子来说明一下npoi.net的整体使用，如果有任何说错的地方，还请你指出来，小菜谢过了。

我个人认为会遇到的问题我都在注释中写了，

public class NpoiNet
{
public void CreateWorkBook()
{
string filePath = HttpContext.Current.Server.MapPath("~/npoi.xls");
//表示一个文件流
FileStream fileStream = new FileStream(filePath, FileMode.Create, FileAccess.ReadWrite);
HSSFWorkbook workBook = new HSSFWorkbook();//相当于创建了一个内存中的Excel 只是还没有写到硬盘上
try
{
/*按照约定在每个Excel文件中至少要包含一个sheet，如果没有任何sheet，打开Excel文件的时候会报错。
在以前的npoi版本中，如果不是自己手动的创建一个sheet，npoi框架是不会自动创建一个的，但是在最新版的1.2.5中，
我发现即使你忘记了创建sheet的操作，框架会自动创建一个sheet，当然如果你手动创建了一个sheet，则框架就不会
自动的创建一个sheet，这就像构造函数，如果没有写任何一个，.Net会默认存在一个，但是你创建了一个构造函数，则
* 框架就不会自动创建了
* */

workBook.CreateSheet("guozhiqi");//sheet的名称为guozhiqi
workBook.CreateSheet();//sheet的名称为sheet1  从1开始命名
workBook.CreateSheet("yuanjinzhou");
workBook.CreateSheet();//这个sheet的名称应该为什么？答案是sheet3
//创建了sheet 下面我们来创建单元格
HSSFSheet sheetGuozhiqi = (HSSFSheet)workBook.GetSheet("guozhiqi");//获取到sheet名称为guozhiqi的那个工作簿
//创建了工作簿 添加单元格之前首先要添加行
//在这里请注意  行和列的下标都是从0开始的 而不是Excel文件中的1
for (int i = 0; i <= 10; i++)
{
sheetGuozhiqi.CreateRow(i);//创建了11行
}

//创建了行之后 就要在每个行中创建单元格
//如果没有在之前创建行
//  HSSFRow newRow = (HSSFRow)sheetGuozhiqi.GetRow(12);这是错误的 程序会报异常 这就告诉我们 如果行还没有创建
//就不可以获取
HSSFRow newRow = (HSSFRow)sheetGuozhiqi.GetRow(0);

HSSFCell[] cells = new HSSFCell[11];
//在第0行的位置创建单元格
for (int i = 0; i <= 10; i++)
{
cells[i] = (HSSFCell)newRow.CreateCell(i);//为第0行创建了10个单元格
}
//这里取得单元格的异常出现位置相同 就是如果没有创建就不要试图获取
HSSFCell newCell = (HSSFCell)newRow.GetCell(0);//取得第0行第0个单元格

//获取到了单元格 赋值 为了方便说明 我多获取几个单元格的值
//Excel单元格有很多类型 例如字符串 数字 bool等类型，
cells[0].SetCellValue(false);//赋值为bool型
cells[1].SetCellValue(DateTime.Now);//赋值为日期型
cells[2].SetCellValue(3.1415926);//赋值为double类型
cells[3].SetCellValue("guozhiqi");//赋值为字符串guozhiqi

//为单元格赋值以后 我们就要开始取值了
bool cell0 = cells[0].BooleanCellValue;
// string cell00 = cells[0].StringCellValue; 错误 这句话的意思就是说存储的时候是什么类型 就必须用对应的
//取值方法取值
DateTime dateTime = cells[1].DateCellValue;
double cell2 = cells[2].NumericCellValue;
string cell3 = cells[3].StringCellValue;

//可以正常创建单元格 从单元格取值是远远不够的 还有就是客户可能会要求合并单元格  为单元格设置样式
//合并单元格的操作不必要创建所有的行或列，只需要制定范围即可
sheetGuozhiqi.AddMergedRegion(new NPOI.SS.Util.Region(1,1,20,20));//合并单元格

HSSFCellStyle cellStyle = (HSSFCellStyle)workBook.CreateCellStyle();
cellStyle.Alignment = HorizontalAlignment.CENTER;//居中显示
cellStyle.FillBackgroundColor = 244;
cellStyle.FillPattern = FillPatternType.BRICKS;//填充模式
cellStyle.IsHidden = false;//单元格是否隐藏
cellStyle.IsLocked = false;//单元格是否锁定
cellStyle.VerticalAlignment = VerticalAlignment.CENTER;//垂直居中

//设置单元格字体
HSSFFont font =(HSSFFont) workBook.CreateFont();
font.Color = 200;
font.FontHeight = 18;//设置字体大小
font.FontName = "黑体";//设置字体为黑体
font.IsItalic = false;//是否是斜体
font.IsStrikeout = true;//是否有中间线
font.Underline = (byte)FontUnderlineType.DOUBLE;//设置下划线

cellStyle.SetFont(font);
//将设置好的样式应用到对应的单元格上 否则是没有效果的
cells[0].CellStyle = cellStyle;

if (!workBook.IsWriteProtected)
{
workBook.Write(fileStream);
}
}
catch (Exception ex)
{
HttpContext.Current.Response.Write(ex.Message+ex.Source+ex.StackTrace);
}
finally
{
if (fileStream != null)
{
fileStream.Close();
}
}
}
}

总结，既然这篇博客是Npoi.net的总结，那么我不可能就是举了一个例子就算了事，毕竟博客园中园友们举得例子已经够多了，下面我就把在使用npoi.net会遇到的一些小问题总结一下。

在实例化了一个WorkBook之后，最好添加一个sheet，虽然在最新版的Npoi.net中自动添加了，但是遇到迁移到原来版本就会出现问题。所以我建议还是最少添加一个sheet

在从单元格取值时要注意单元格的类型，一定要用对应的类型的方法来取单元格中的对应类型的值，如果不确定，那只能是强制转换成为string类型，毕竟string类型是excel中其他类型都可以转换过来的

在获取sheet中的某一行或者某一行的某一个单元格的时候，还要注意就是一定要确保创建了该行，并且取单元格还要确保创建了单元格，否则会报Null reference not to object 这个我们经常会看到的异常信息。在外层一定要加上try捕获异常

合并单元格是sheet的工作，因此需要获取对应的sheet，然后调用其AddMergedRegion方法合并单元格，在合并单元格的时候，我们不需要确保该单元格已经存在或创建。

在为单元格设置样式的过程中，我们会发现所有和样式相关的类的创建都是通过workBook.Create(Font)..这种方式来执行的，我们不可以直接new一个类的实例。

如果前面的工作都已经做好，需要把内存中的excel表写到硬盘上时，需要调用workBook.write()方法，传入一个文件流进行创建。在这里有可能会出现一个问题，就是你要创建的文件你已经打开了，这时程序就会出现异常，因此我们在调试程序的时候一定要记得打开了excel文件以后要关闭

最后需要注意的就是文件流，在我们把excel写到硬盘上以后，要显式的调用其close（）方法关闭文件流。因为如果不关闭文件流的话，以后就会出现无法重新创建该文件的错误，并且会提示 某文件正由另一进程使用，因此该进程无法访问此文件。

好了，我能想到的基本上都写出来了，感觉好多了，一会再分析一下c#类和结构的区别。相信很多园友都知道，但是不一定会很明确，那么我就来帮大家回忆一下曾经的学习。夜深人静，确实是写作的好时候。