【转】NPOI使用手册

目前POI版本中的HWPF（用于Word的读写库）还不是很稳定，并不是正式发布版本，且负责HWPF的关键开发人员已经离开，因此NPOI可能考虑本身从新开发HWPF。另外，目前微软正在开发Open XML Format SDK，NPOI可能会放弃对ooxml的支持，固然这取决于用户的需求和Open XML Format SDK的稳定性和速度。从目前而言，NPOI有几大优点

第一，彻底基于.NET 2.0，而非.NET 3.0/3.5。

第二，读写速度快（有个国外的兄弟回复说，他原来用ExcelPackage生成用了4-5个小时，如今只须要4-5分钟）

第三，稳定性好（相对于用Office OIA而言，毕竟那东西是基于Automation作的，在Server上跑个Automation的东西，想一想都以为可怕），跑过了将近1000个测试用例（来自于POI的testcase目录）

第四，API简单易用，固然这得感谢POI的设计师们

第五，完美支持Excel 2003格式（听说myxls没法正确读取xls模板，但NPOI能够），之后也许是全部Office 2003格式

但愿NPOI把这些优点继续发扬下去，这样NPOI才会更有竞争力。

1.6 NPOI 1.2中各Assembly的做用

NPOI目前有好几个assembly，每一个的做用各有不一样，开发人员能够按需加载相应的assembly。在这里大概罗列一下：

NPOI.Util  基础辅助库
NPOI.POIFS   OLE2格式读写库
NPOI.DDF   Microsoft Drawing格式读写库
NPOI.SS   Excel公式计算库
NPOI.HPSF   OLE2的Summary Information和Document Summary Information属性读写库
NPOI.HSSF   Excel BIFF格式读写库

NPOI 1.2教程 - 2.1.1 建立Workbook和Sheet

做者：Tony Qu

NPOI官方网站：http://npoi.codeplex.com/

建立Workbook说白了就是建立一个Excel文件，固然在NPOI中更准确的表示是在内存中建立一个Workbook对象流。

本节做为第2章的开篇章节，将作较为详细的讲解，以帮助NPOI的学习者更好的理解NPOI的组成和使用。

NPOI.HSSF是专门负责Excel BIFF格式的命名空间，供开发者使用的对象主要位于NPOI.HSSF.UserModel和NPOI.HSSF.Util命名空间下，下面咱们要讲到的Workbook的建立用的就是NPOI.HSSF.UserModel.HSSFWorkbook类，这个类负责建立.xls文档。

在开始建立Workbook以前，咱们先要在项目中引用一些必要的NPOI assembly，以下所示：

NPOI.dll

NPOI.POIFS.dll

NPOI.HSSF.dll

NPOI.Util.dll

要建立一个新的xls文件其实很简单，只要咱们初始化一个新的HSSFWorkbook实例就好了，以下所示：

using NPOI.HSSF.UserModel;

...

HSSFWorkbookhssfworkbook =newHSSFWorkbook();

是否是很方便啊，没有任何参数或设置，但这么建立有一些限制，这样建立出来的Workbook在Excel中打开是会报错的，由于Excel规定一个Workbook必须至少带1个Sheet，这也是为何在Excel界面中，新建一个Workbook默认都会新建3个Sheet。因此必须加入下面的建立Sheet的代码才能保证生成的文件正常：

HSSFSheetsheet = hssfworkbook.CreateSheet("newsheet");

若是要建立标准的Excel文件，即拥有3个Sheet，能够用下面的代码：

hssfworkbook.CreateSheet("Sheet1");

hssfworkbook.CreateSheet("Sheet2");

hssfworkbook.CreateSheet("Sheet3");

最后就是把这个HSSFWorkbook实例写入文件了，代码也很简单，以下所示：

FileStreamfile =new FileStream(@"test.xls", FileMode.Create);

hssfworkbook.Write(file);

file.Close();

这里假设文件名是test.xls，，在建立完FileStream以后，直接调用HSSFWorkbook类的Write方法就能够了。

最后你能够打开test.xls文件确认一下，是否是有3个空的Sheet。

相关范例请见NPOI 1.2正式版中的CreateEmptyExcelFile项目。

NPOI 1.2教程 - 2.1.2 建立DocumentSummaryInformation和SummaryInformation

做者：Tony Qu

NPOI官方网站：http://npoi.codeplex.com/

昨天收到了很多回复，有msn上的，也有blog上的，我表明NPOI Team向全部支持和关注NPOI的兄弟表示感谢，让咱们共同完善NPOI。

前一节中咱们讲解了如何建立一个新的Workbook，但在此过程当中你们也许会发现一个细节，这些文件没有包括DocummentSummaryInformation和SummaryInformation头。若是你还不是很清楚我在说什么，能够看POIFS Browser打开test.xls文件后的截图：

你会发现只有Workbook目录，其余什么都没有，但事实上一个正常的xls文件，好比说Excel生成的xls文件是相似下面的结构：

是否是多出来DocumentSummaryInformation和SummaryInformation两个头？不少人可能对DocumentSummaryInformation和SummaryInformation很陌生，可能第一次据说这玩意，没事，这很正常，由于普通用户不多会去使用这些东西，但它们其实比想象中有用。

请看上图中的信息，如做者、标题、标记、备注、主题等信息，其实这些信息都是存储在DocummentSummaryInformation和SummaryInformation里面的，这么一说我想你们应该明白了吧，这些信息是为了快速提取文件信息准备。在Windows XP中，也有对应的查看和修改界面，只是没有Vista这么方便，以下所示：

这恐怕也是不少人对于这些信息不闻不问的缘由吧，由于没有人愿意经过右击文件->属性这样复杂的操做去查看一些摘要信息。

提示

DocummentSummaryInformation和SummaryInformation并非Office文件的专利，只要是OLE2格式，均可以拥有这两个头信息，主要目的就是为了在没有完整读取文件数据的状况下得到文件的摘要信息，同时也可用做桌面搜素的依据。要了解DocummentSummaryInformation的所有属性请见http://msdn.microsoft.com/en-us/library/aa380374(VS.85).aspx；要了解SummaryInformation的所有属性请见http://msdn.microsoft.com/en-us/library/aa369794(VS.85).aspx。

好了，说到这里，我想你们对于接下来咱们要建立的内容有了初步的认识，下面咱们就立刻动手建立。

首先引用如下这些命名空间：

using NPOI.HSSF.UserModel;

using NPOI.HPSF;

using NPOI.POIFS.FileSystem;

其中与DocummentSummaryInformation和SummaryInformation密切相关的是HPSF命名空间。

首先建立Workbook

HSSFWorkbookhssfworkbook =newHSSFWorkbook();

而后建立DocumentSummaryInformation

DocumentSummaryInformationdsi = PropertySetFactory.CreateDocumentSummaryInformation();

dsi.Company ="NPOI Team";

再建立SummaryInformation

SummaryInformationsi = PropertySetFactory.CreateSummaryInformation();

si.Subject ="NPOI SDK Example";

由于是范例，这里仅各设置了一个属性，其余都没有设置。

如今咱们把建立好的对象赋给Workbook，这样才能保证这些信息被写入文件。

hssfworkbook.DocumentSummaryInformation= dsi;

hssfworkbook.SummaryInformation= si;

最后和2.1.1节同样，咱们把Workbook经过FileStream写入文件。

相关范例请见NPOI 1.2正式版中的CreatePOIFSFileWithProperties

NPOI 1.2教程 - 2.1.3 建立单元格

做者：Tony Qu

NPOI官方网站：http://npoi.codeplex.com/

用过Excel的人都知道，单元格是Excel最有意义的东西，咱们作任何操做恐怕都要和单元格打交道。在Excel中咱们要添加一个单元格只须要点击任何一个单元格，而后输入内容就是了，可是Excel底层其实没有这么简单，不一样的单元格是有不一样的类型的，好比说数值单元格是用NumberRecord表示，文本单元格是用LabelSSTRecord表示，空单元格是用BlankRecord表示。这也就意味着，在设置单元格时，你必须告诉NPOI你须要建立哪一种类型的单元格。

要建立单元格首先要建立单元格所在的行，好比，下面的代码建立了第0行：

HSSFSheetsheet1 = hssfworkbook.CreateSheet("Sheet1");

HSSFRowrow1=sheet1.CreateRow(0);

行建好了，就能够建单元格了，好比建立A1位置的单元格：

row1.CreateCell(0).SetCellValue(1);

这里要说明一下，SetCellValue有好几种重载，你能够设置单元格为bool、double、DateTime、string和HSSFRichTextString类型。其中对于string类型的重载调用的就是HSSFRichTextString类型的重载，因此是同样的，HSSFRichTextString可用于有字体或者Unicode的文本。

若是你以为每一行要声明一个HSSFRow很麻烦，能够用下面的方式：

sheet1.CreateRow(0).CreateCell(0).SetCellValue("This is a Sample");

这么用有个前提，那就是第0行还没建立过，不然得这么用：

sheet1.GetRow(0).CreateCell(0).SetCellValue("This is a Sample");

注意：这里的行在Excel里是从1开始的，可是NPOI内部是从0开始的；列在Excel里面是用字母表示的，而NPOI中也是用从0开始的数字表示的，因此要注意转换。

若是你要得到某一个已经建立的单元格对象，能够用下面的代码：

sheet1.GetRow(row_index).GetCell(column_index);

本节仅讲解最基本的单元格建立，有关单元格格式设置、样式等高级话题请见：2.2节单元格相关操做。

相关范例请见NPOI 1.2正式版中的SetCellValuesInXls项目。

NPOI 1.2教程 - 2.1.4 建立批注

做者：Tony Qu

NPOI官方网站：http://npoi.codeplex.com/

不少人不怎么用Excel中的批注，因此我特意截了张图，让你们知道本节咱们要建立的究竟是什么东西。

在过去，咱们恐怕没有办法实现这一功能，由于不管是cvs法、html法、oledb法都没有提供这样的接口，固然Office PIA法能够作到，可是性能实在太差，并且稳定性很差，常常莫名其妙crash（这是某某兄弟给个人反馈，我引用了下，呵呵）。在之后的教程中，你将看到更多在过去没法经过传统方法实现的东西，好戏才刚刚开始。

批注主要有三个属性须要设置，一个是批注的位置和大小、一个是批注的文本、还有一个是批注的做者。

批注的位置和大小，在Excel中是与单元格密切相关的，NPOI中经过HSSFClientAnchor的实例来表示，它的构造函数比较复杂，有8个参数，它们分别是

参数	说明
dx1	第1个单元格中x轴的偏移量
dy1	第1个单元格中y轴的偏移量
dx2	第2个单元格中x轴的偏移量
dy2	第2个单元格中y轴的偏移量
col1	第1个单元格的列号
row1	第1个单元格的行号
col2	第2个单元格的列号
row2	第2个单元格的行号

例如，若是咱们打算让注释显示在B3和E5之间，就应该这么写：

HSSFPatriarchpatr = sheet.CreateDrawingPatriarch();

HSSFCommentcomment1 = patr.CreateComment(new HSSFClientAnchor(0, 0, 0, 0, 1, 2 , 4, 4));

下面咱们设置这个批注的内容和做者，这个比较简单：

comment1.String=newHSSFRichTextString("Hello World");

comment1.Author="NPOI Team";

最后一步就是把批注赋给某个单元格：

HSSFCell cell= sheet.CreateRow(1).CreateCell(1);

cell.CellComment= comment1;

对于批注，你有两种选择，一种是隐藏（默认），一种是显示（即表单一打开就显示该批注），能够经过comment1.Visible属性来控制。

看了上面这张图你们就应该明白了，这里有2个批注，下面那个是显示的，上面那个是隐藏的。

相关范例请见NPOI 1.2正式版中的SetCellCommentInXls。

NPOI 1.2教程 - 2.1.6 建立页眉和页脚

做者：Tony Qu

NPOI官方网站：http://npoi.codeplex.com/

不少人并不知道Excel的页眉和页脚功能，由于在界面上是显示不了页眉和页脚的，必须在打印页面中才能看到，这也直接致使了其设置界面也显得更隐秘，你必须进入页面设置 –>页眉和页脚才能设置。如下是Office 2007中的设置界面。

当你按“自定义页眉”或“自定义页脚”时，你会看到如下界面，Excel把页眉、页脚分红了左中右三部分，这一点绝非单纯体如今界面上，在底层的存储中也是如此。若是你设置的是“左”的内容，底层的存储字符串就会在开头加上&L，若是是“右”的内容则会加上&R，因此HeaderRecord中的字符串看上去是这样的："&C&LFooter A&R”，这个字符串的意思是仅设置了“左”的内容，内容是Footer A。

看了这些我想你应该对页眉和页脚有所了解了，回过头来讲NPOI，NPOI中主要是靠HSSFSheet.Header和HSSFSheet.Footer来设置的，这两个属性分别是HSSFHeader和HSSFFooter类型的。

参考代码以下：

HSSFSheet s1= hssfworkbook.CreateSheet("Sheet1");

s1.CreateRow(0).CreateCell(1).SetCellValue(123);

//set headertext

s1.Header.Center="This is a test sheet";

//set footertext

s1.Footer.Left="Copyright NPOI Team";

s1.Footer.Right="created by Tony Qu（瞿杰）";

以上代码中我添加了页眉的Center内容，Footer的Left和Right内容，在打印预览中看到的效果大概是这样的：

页眉

页脚

至于一些Excel特殊字符，好比说页码能够用&P，当前日期能够用&D，其余的东西你就本身研究吧。

本范例完整代码请见NPOI.Examples中的CreateHeaderFooterInXls项目。

NPOI 1.2教程 - 2.2.1 设置单元格格式

做者：Tony Qu

NPOI官方网站：http://npoi.codeplex.com/

在Excel中咱们常常要设置格式，好比说日期格式（yyyymmdd）、小数点格式（1.20）、货币格式（$2000）、百分比格式（99.99%）等等，这些东西在过去咱们恐怕只能在服务器端生成好，不但增长了服务器端的代码量，还形成了没必要要的字符串替换操做，现在NPOI将让服务器从这种彻底没有必要的操做中解放出来，一切都将由Excel在客户端处理。

使用NPOI时要注意，全部的格式都是经过CellStyle.DataFormat赋给单元格的，而不是直接赋给单元格。

案例一日期格式

假设咱们如今须要显示的日期的格式为2008年5月5日，能够用下面的代码生成：

HSSFSheetsheet = hssfworkbook.CreateSheet("newsheet");

HSSFCell cell= sheet.CreateRow(0).CreateCell(0);

cell.SetCellValue(newDateTime(2008,5,5));

//set dateformat

HSSFCellStylecellStyle = hssfworkbook.CreateCellStyle();

HSSFDataFormatformat = hssfworkbook.CreateDataFormat();

cellStyle.DataFormat= format.GetFormat("yyyy年m月d日");

cell.CellStyle=cellStyle;

因为这里的“yyyy年m月d日”属于自定义格式（区别于Excel内嵌的格式），因此必须用hssfworkbook.CreateDataFormat()建立一个HSSFDataFormat实例，而后使用format.GetFormat来获取相应的格式，只要是Excel支持的格式表示方式，这种方式都可以实现。

案例二保留2位小数

假设咱们有个单元格的值为1.2，怎么显示成1.20呢？在Excel中能够用“0.00”来表示，因此下面的代码就能完成：

// Create arow and put some cells in it. Rows are 0 based.

HSSFCell cell= sheet.CreateRow(0).CreateCell(0);

//set valuefor the cell

cell.SetCellValue(1.2);

//numberformat with 2 digits after the decimal point - "1.20"

HSSFCellStylecellStyle = hssfworkbook.CreateCellStyle();

cellStyle.DataFormat= HSSFDataFormat.GetBuiltinFormat("0.00");

cell.CellStyle= cellStyle;

这里与上面有所不一样，用的是HSSFDataFormat.GetBuiltinFormat()方法，之因此用这个，是由于0.00是Excel内嵌的格式，完整的Excel内嵌格式列表你们能够看这个窗口中的自定义列表：

这里就不一一列出了。

案例三货币格式

货币格式在金融的项目中常常用到，好比说人民币符号¥，美圆符号$等，这里能够用下面的代码表示：

HSSFCellcell2 = sheet.CreateRow(1).CreateCell(0);

cell2.SetCellValue(20000);

HSSFCellStylecellStyle2 = hssfworkbook.CreateCellStyle();

HSSFDataFormatformat = hssfworkbook.CreateDataFormat();

cellStyle2.DataFormat= format.GetFormat("¥#,##0");

cell2.CellStyle= cellStyle2;

注意，这里还加入了千分位分隔符，因此是#,##，至于为何这么写，你得去问微软，呵呵。

案例四百分比

百分比在报表中也很经常使用，其实基本上和上面同样，只是格式表示是0.00%，代码以下：

cellStyle4.DataFormat= HSSFDataFormat.GetBuiltinFormat("0.00%");

因为这里是内嵌格式，因此直接用HSSFDataFormat.GetBuiltinFormat便可。

案例五中文大写

在表示金额时，咱们时常会用到，我也见过很多兄弟实现了数字转中文大小写的工具类，之后你能够尝试让Excel去处理这一切，代码和刚才差很少，也是改格式的表示：

HSSFDataFormatformat = hssfworkbook.CreateDataFormat();

cellStyle6.DataFormat= format.GetFormat("[DbNum2][$-804]0");

因为是自定义格式，因此用了HSSFDataFormat.GetFormat，相信你对这两种获取格式的形式的区别愈来愈熟悉了。

案例六科学计数法

这东西数学课上咱们都学过，虽然用的很少，可是既然Excel支持，这里也提一下：

cellStyle3.DataFormat= HSSFDataFormat.GetBuiltinFormat("0.00E+00");

下面展现下以上这些例子的显示效果：

最后总结一下HSSFDataFormat.GetFormat和HSSFDataFormat.GetBuiltinFormat的区别：

当使用Excel内嵌的（或者说预约义）的格式时，直接用HSSFDataFormat.GetBuiltinFormat静态方法便可。

当使用本身定义的格式时，必须先调用HSSFWorkbook.CreateDataFormat()，由于这时在底层会先找有没有匹配的内嵌FormatRecord，若是没有就会新建一个FormatRecord，因此必须先调用这个方法，而后你就能够用得到的HSSFDataFormat实例的GetFormat方法了，固然相对而言这种方式比较麻烦，因此内嵌格式仍是用HSSFDataFormat.GetBuiltinFormat静态方法更加直接一些。不过自定义的格式也不是天马行空随便定义，仍是要参照Excel的格式表示来定义，具体请看相关的Excel教程。

注意：自定义的FormatRecord是嵌入xls文件内部的，因此不用担忧对方Excel中有没有定义过这种格式，都是可以正常使用的。

相关范例请参考NPOI 1.2正式版中的NumberFormatInXls项目。

NPOI 1.2教程 - 2.2.2 单元格合并

做者：Tony Qu

NPOI官方网站：http://npoi.codeplex.com/

合并单元格在制做表格时颇有用，好比说表格的标题就常常是把第一行的单元格合并居中。那么在NPOI中应该如何实现单元格的合并呢？

为了实现这一功能，NPOI引入了新的概念，即Region，由于合并单元格，其实就是设定一个区域。下面说一下Region类的参数，Region总共有4个参数，以下所示

Region的参数	说明
FirstRow	区域中第一个单元格的行号
FirstColumn	区域中第一个单元格的列号
LastRow	区域中最后一个单元格的行号
LastColumn	区域中最后一个单元格的列号

因为单元格的合并都是在表的基础上创建的，因此咱们得先建Sheet：

HSSFWorkbookhssfworkbook =newHSSFWorkbook();

HSSFSheetsheet = hssfworkbook.CreateSheet("newsheet");

接下来咱们根据实际场景来作一些演示。

场景一标题行的合并

这种场景是最多见的，好比说咱们要创建一张销售状况表，英文叫Sales Report

咱们先设置居中和字体样式，这里咱们采用20号字体，代码以下：

HSSFRow row =sheet.CreateRow(0);

HSSFCell cell= row.CreateCell(0);

cell.SetCellValue("Sales Report");

HSSFCellStylestyle = hssfworkbook.CreateCellStyle();

style.Alignment= HSSFCellStyle.ALIGN_CENTER;

HSSFFont font= hssfworkbook.CreateFont();

font.FontHeight= 20*20;

style.SetFont(font);

cell.CellStyle= style;

要产生图中的效果，即把A1:F1这6个单元格合并，而后添加合并区域：

sheet.AddMergedRegion(new Region(0, 0, 0,5));

场景二多行合并

看完场景一，你可不要认为多行合并就须要一行一行作，其实也只须要一行代码，好比说咱们要把C3:E5合并为一个单元格，那么就能够用下面的代码：

sheet.AddMergedRegion(new Region(2, 2, 4,4));

提示即便你没有用CreateRow和CreateCell建立过行或单元格，也彻底能够直接建立区域而后把这一区域合并，Excel的区域合并信息是单独存储的，和RowRecord、ColumnInfoRecord不存在直接关系。

相关范例请参考NPOI 1.2正式版中的MergedCellInXls项目。

NPOI 1.2教程 - 2.2.3 单元格对齐相关设置

做者：Tony Qu

NPOI官方网站：http://npoi.codeplex.com/

本节将围绕“对齐”选项卡中的设置展开，虽然实际上你会发现该选项卡中的不少设置和对齐没有什么关系。合并单元格已经在2.2.2节讲过了，这里就不提了。

首先咱们用代码建立必要的单元格，代码以下：

HSSFWorkbookhssfworkbook =new HSSFWorkbook();

HSSFSheetsheet1 = hssfworkbook.CreateSheet("Sheet1");

HSSFRow row =sheet1.CreateRow(0);

row.CreateCell(0).SetCellValue("Test");

这里咱们假设在A0单元格中加入了文本Test。

请注意接下来咱们要作的全部操做都是在CellStyle的基础上完成的，因此咱们建立一个HSSFCellStyle：

HSSFCellStylestyle=hssfworkbook.CreateCellStyle();

水平对齐

这里用的是HSSFCellStyle.Alignment，默认值天然是常规，即HSSFCellStyle.ALIGN_GENERAL。

若是是左侧对齐就是

style.Alignment= HSSFCellStyle.ALIGN_LEFT;

若是是居中对齐就是

style.Alignment= HSSFCellStyle.ALIGN_CENTER;

若是是右侧对齐就是

style.Alignment= HSSFCellStyle.ALIGN_RIGHT;

若是是跨列举中就是

style.Alignment= HSSFCellStyle.ALIGN_CENTER_SELECTION;

若是是两端对齐就是

style.Alignment= HSSFCellStyle.ALIGN_JUSTIFY;

若是是填充就是

style.Alignment= HSSFCellStyle.ALIGN_FILL;

注意：以上选项仅当有足够的宽度时才能产生效果，不设置宽度恐怕看不出区别。

垂直对齐

这里用的是HSSFCellStyle.VerticalAlignment，默认值为居中，即HSSFCellStyle.VERTICAL_CENTER

若是是靠上就是

style.VerticalAlignment=HSSFCellStyle.VERTICAL_TOP

若是是居中就是

style.VerticalAlignment=HSSFCellStyle.VERTICAL_CENTER

若是是靠下就是

style.VerticalAlignment=HSSFCellStyle.VERTICAL_BOTTOM

若是是两端对齐就是

style.VerticalAlignment=HSSFCellStyle.VERTICAL_JUSTIFY

注意：以上选项仅当有足够的高度时才能产生效果，不设置高度恐怕看不出区别。

自动换行

自动换行翻译成英文其实就是Wrap的意思，因此这里咱们应该用WrapText属性，这是一个布尔属性

style.WrapText=true;

效果以下所示：

文本缩进

这是一个不太引人注意的选项，因此这里给张图出来，让你们知道是什么，缩进说白了就是文本前面的空白，咱们一样能够用属性来设置，这个属性叫作Indention。

style.Indention= 3;

文本旋转

文本方向你们必定在Excel中设置过，上图中就是调整界面，主要参数是度数，那么咱们如何在NPOI中设置呢？

style.Rotation=(short)90;

以上代码是把单元格A1中的文本逆时针旋转90度，等同于下图中的设置：

请注意，这里的Rotation取值是从-90到90，而不是0-180度。

最后别忘了把样式变量style赋给HSSFCellStyle.CellStyle，不然就前功尽弃了，呵呵！

以上的一些功能，好比文本旋转和自动换行，使用传统的cvs和html法恐怕是没法实现的。随着学习的不断深刻，你将愈来愈意识到使用NPOI生成Excel其实如此简单。

相关范例请参考NPOI 1.2正式版中的SetAlignmentInXls和RotateTextInXls。

NPOI 1.2教程 - 2.2.4 设置单元格边框

做者：Tony Qu

NPOI官方网站：http://npoi.codeplex.com/

不少表格中都要使用边框，本节将为你重点讲解NPOI中边框的设置和使用。

边框和其余单元格设置同样也是在HSSFCellStyle上操做的，HSSFCellStyle有2种和边框相关的属性，分别是:

边框相关属性	说明	范例
Border+方向	边框类型	BorderTop, BorderBottom,BorderLeft, BorderRight
方向+BorderColor	边框颜色	TopBorderColor,BottomBorderColor, LeftBorderColor, RightBorderColor

其中边框类型分为如下几种：

边框范例图	对应的静态值
	HSSFCellStyle.BORDER_DOTTED
	HSSFCellStyle.BORDER_HAIR
	HSSFCellStyle.BORDER_DASH_DOT_DOT
	HSSFCellStyle.BORDER_DASH_DOT
	HSSFCellStyle.BORDER_DASHED
	HSSFCellStyle.BORDER_THIN
	HSSFCellStyle.BORDER_MEDIUM_DASH_DOT_DOT
	HSSFCellStyle.BORDER_SLANTED_DASH_DOT
	HSSFCellStyle.BORDER_MEDIUM_DASH_DOT
	HSSFCellStyle.BORDER_MEDIUM_DASHED
	HSSFCellStyle.BORDER_MEDIUM
	HSSFCellStyle.BORDER_THICK
	HSSFCellStyle.BORDER_DOUBLE

至于颜色那就不少了，所有在HSSFColor下面，如HSSFColor.GREEN,HSSFColor.RED，都是静态实例，能够直接引用。

下面咱们假设咱们要把一个单元格的四周边框都设置上，能够用下面的代码：

HSSFSheetsheet = hssfworkbook.CreateSheet("newsheet");

// Create arow and put some cells in it. Rows are 0 based.

HSSFRow row =sheet.CreateRow(1);

// Create acell and put a value in it.

HSSFCell cell= row.CreateCell(1);

// Style thecell with borders all around.

HSSFCellStylestyle = hssfworkbook.CreateCellStyle();

style.BorderBottom=HSSFCellStyle.BORDER_THIN;

style.BorderLeft=HSSFCellStyle.BORDER_THIN;

style.BorderRight=HSSFCellStyle.BORDER_THIN;

style.BorderTop= HSSFCellStyle.BORDER_THIN ;

cell.CellStyle=style;

这段代码使用了最普通的细边框，使得这个单元格看上去像块空心砖头。

注意：这里咱们没有设置边框的颜色，但这不会影响最终的效果，由于Excel会用默认的黑色给边框上色。

若是要设置颜色的话，也很简单，以下：

style.BottomBorderColor=HSSFColor.GREEN.index;

以上代码将底部边框设置为绿色，要注意，不是直接把HSSFColor.GREEN赋给XXXXBorderColor属性，而是把index的值赋给它。

相关范例请参考NPOI 1.2正式版中的SetBorderStyleInXls项目。

NPOI 1.2教程 - 2.2.5 设置单元格字体

做者：Tony Qu

NPOI官方网站：http://npoi.codeplex.com/

本节咱们将继续使用NPOI来设置单元格格式，这一节咱们主要讲如何设置“字体”。

在设置字体以前，咱们首先要作的就是建立字体对象，这和建立数字格式很类似。

HSSFFont font= hssfworkbook.CreateFont();

这句话会在Excel文件内部建立相应的FontRecord，因此你不用客户由于本身机器上的Excel没有相应的字体设置而致使设置丢失。

字体在设置完成后，咱们就能够把它赋给单元格样式，代码以下：

HSSFCellStylestyle1 = hssfworkbook.CreateCellStyle();

style1.SetFont(font);

cell1.CellStyle=style1;

这里的cell1是HSSFCell的一个实例。

好了，下面咱们就开始对字体进行设置。

字体名称

这里的字体名称是经过HSSFFont.FontName进行设置的，至于具体的名称，只要是经常使用字体均可以，好比说Arial, Verdana等，固然也能够是中文字体名，如宋体、黑体等。不过设置字体名称有个前提，那就是假设打开这个xls文件的客户机上有这种字体，若是没有，Excel将使用默认字体。

下面就是设置字体名称为“宋体”的代码：

font.FontName="宋体";

字号

与字号有关的属性有两个，一个是FontHeight，一个是FontHeightInPoints。区别在于，FontHeight的值是FontHeightInPoints的20倍，一般咱们在Excel界面中看到的字号，好比说12，对应的是FontHeightInPoints的值，而FontHeight要产生12号字体的大小，值应该是240。因此一般建议你用FontHeightInPoint属性。

若是要设置字号为12，代码就是

font.FontHeightInPoints= 12;

字体颜色

这里可能会与CellStyle上的ForegroundColor和BackgroundColor产生混淆，其实全部的字体颜色都是在HSSFFont的实例上设置的，CellStyle的ForegroundColor和BackgroundColor分别指背景填充色和填充图案的颜色，和文本颜色无关。

要设置字体颜色，咱们能够用HSSFFont.Color属性，颜色能够经过HSSFColor得到，代码以下所示：

font.Color =HSSFColor.RED.index;

这行代码把文本设置为红色。

下划线

一般咱们所说的下划线都是单线条的，其实Excel支持好几种下划线，以下所示：

类型	对应的值
单下划线	HSSFFont.U_SINGLE
双下划线	HSSFFont.U_DOUBLE
会计用单下划线	HSSFFont.U_SINGLE_ACCOUNTING
会计用双下划线	HSSFFont.U_DOUBLE_ACCOUNTING
无下划线	HSSFFont.U_NONE

当你要设置下划线时，能够用HSSFFont.Underline属性，这是一个byte类型的值，例如

font.Underline=HSSFFont.U_SINGLE

这行代码就是设置单下划线的代码。

上标下标

设置这东西能够用HSSFFont.TypeOffset属性，值有如下几种：

TypeOffset的值	说明
HSSFFont.SS_SUPER	上标
HSSFFont.SS_SUB	下标
HSSFFont.SS_NONE	普通，默认值

因此若是你要上标的话，能够用下面的代码：

font.TypeOffset=HSSFFont.SS_SUPER;

删除线

设置这东西能够用HSSFFont.IsStrikeout属性，当为true时，表示有删除线；为false则表示没有删除线。

相关范例请参考NPOI 1.2正式版中的ApplyFontInXls的项目。

NPOI 1.2教程 - 2.2.6设置单元格的背景和图案

做者：Tony Qu

NPOI官方网站：http://npoi.codeplex.com/

本节咱们将用NPOI来为单元格添加背景和图案。

在以前的教程中，咱们已经提到HSSFCellStyle有两个背景颜色属性，一个叫FillBackgroundColor，另外一个叫FillForegroundColor，但其实这指的都是背景颜色，那为何还有ForegroundColor呢？为了可以帮助你们理解，咱们举一个实际的例子，下面这个图案是Excel的一个单元格：

线是白色的，背景是红色的。这里的线其实就是下面的Excel界面中的图案：

至于线的颜色则是图案颜色，即白色。

因此以上单元格若是要用NPOI来设置就能够用如下代码完成：

//fillbackground

HSSFCellStylestyle8 = hssfworkbook.CreateCellStyle();

style8.FillForegroundColor= NPOI.HSSF.Util.HSSFColor.WHITE.index;

style8.FillPattern= HSSFCellStyle.SQUARES;

style8.FillBackgroundColor= NPOI.HSSF.Util.HSSFColor.RED.index;

sheet1.CreateRow(7).CreateCell(0).CellStyle= style8;

如今是否是清楚一些了，这里的FillPattern就图案样式，全部的枚举值都是HSSFCellStyle的常量；FillForegroundColor就是图案的颜色，而FillBackgroundColor则是背景的颜色，即红色。

下面罗列一下图案样式及其对应的值：

图案样式	常量
	HSSFCellStyle.NO_FILL
	HSSFCellStyle.ALT_BARS
	HSSFCellStyle.FINE_DOTS
	HSSFCellStyle.SPARSE_DOTS
	HSSFCellStyle.LESS_DOTS
	HSSFCellStyle.LEAST_DOTS
	HSSFCellStyle.BRICKS
	HSSFCellStyle.BIG_SPOTS
	HSSFCellStyle.THICK_FORWARD_DIAG
	HSSFCellStyle.THICK_BACKWARD_DIAG
	HSSFCellStyle.THICK_VERT_BANDS
	HSSFCellStyle.THICK_HORZ_BANDS
	HSSFCellStyle.THIN_HORZ_BANDS
	HSSFCellStyle.THIN_VERT_BANDS
	HSSFCellStyle.THIN_BACKWARD_DIAG
	HSSFCellStyle.THIN_FORWARD_DIAG
	HSSFCellStyle.SQUARES
	HSSFCellStyle.DIAMONDS

经过这张表，你将很容易找到本身须要的样式，不用再去一个一个猜想了。

相关范例请参考NPOI 1.2正式版中的ColorfullMatrixTable和FillBackgroundInXls。

NPOI 1.2教程 - 2.2.7 设置单元格的宽度和高度

做者：Tony Qu

NPOI官方网站：http://npoi.codeplex.com/

在Excel中，单元格的宽度其实就是列的宽度，由于Excel假设这一列的单元格的宽度确定一致。因此要设置单元格的宽度，咱们就得从列的宽度下手，HSSFSheet有个方法叫SetColumnWidth，共有两个参数：一个是列的索引（从0开始），一个是宽度。

如今假设你要设置B列的宽度，就能够用下面的代码：

HSSFWorkbookhssfworkbook =newHSSFWorkbook();

HSSFSheetsheet1 = hssfworkbook.CreateSheet("Sheet1");

sheet1.SetColumnWidth(1,100 * 256);

这里你会发现一个有趣的现象，SetColumnWidth的第二个参数要乘以256，这是怎么回事呢？其实，这个参数的单位是1/256个字符宽度，也就是说，这里是把B列的宽度设置为了100个字符。

刚才说的是如何设置，那如何去读取一个列的宽度呢？直接用GetColumnWidth方法，这个方法只有一个参数，那就是列的索引号。以下所示：

int col1width = sheet1.GetColumnWidth(1);

说完宽度，咱们来讲高度，在Excel中，每一行的高度也是要求一致的，因此设置单元格的高度，其实就是设置行的高度，因此相关的属性也应该在HSSFRow上，它就是HSSFRow.Height和HeightInPoints，这两个属性的区别在于HeightInPoints的单位是点，而Height的单位是1/20个点，因此Height的值永远是HeightInPoints的20倍。

要设置第一行的高度，能够用以下代码：

sheet1.CreateRow(0).Height= 200*20;

或者

sheet1.CreateRow(0).HeightInPoints= 200;

若是要得到某一行的行高，能够直接拿HSSFRow.Height属性的返回值。

你可能以为一行一行设置行高或者一列一列设置列宽很麻烦，那你能够考虑使用HSSFSheet.DefaultColumnWidth、HSSFSheet.DefaultRowHeight和HSSFSheet.DefaultRowHeightInPoints属性。

一旦设置了这些属性，若是某一行或者某一列没有设置宽度，就会使用默认宽度或高度。代码以下：

sheet1.DefaultColumnWidth=100*256;

sheet1.DefaultRowHeight=30*20;

相关范例请见NPOI 1.2正式版中的SetWidthAndHeightInXls项目

2.3.1用NPOI操做EXCEL－－基本计算

从这节开始，咱们将开始学习Excel高级一点的功能--公式。为某个单元格指定公式后，单元格中的类容将根据公式计算得出，如图：

图中设置的是一个基本表达式”1+2*3”，单元格A1中将显示此表达式计算的结果”7”，如图所示。对应的C#生成代码也很简单，以下：

一样，NPOI也支持单元格引用类型的公式设置，以下图中的C1=A1*B1。

对应的公式设置代码为：

cel3.SetCellFormula("A1*B1");

是否是很简单呢？但要注意，在利用NPOI写程序时，行和列的计数都是从0开始计算的，但在设置公式时又是按照Excel的单元格命名规则来的。

2.3.2用NPOI操做EXCEL－－SUM函数

这节咱们开始学习Excel中最经常使用的函数—Sum求和函数。

首先，咱们先看一上最简单的Sum函数：Sum(num1,num2,...)。使用效果如图

图中的E1=Sum(A1,C1)表示将A1与C1的和填充在E1处，与公式”E1=A1+C1”等效。对应的生成代码与上一节中的基本计算公式相似：

HSSFSheet sheet1 = hssfworkbook.CreateSheet("Sheet1");
HSSFRow row1 = sheet1.CreateRow(0);
HSSFCell cel1 = row1.CreateCell(0);
HSSFCell cel2 = row1.CreateCell(1);
HSSFCell cel3 = row1.CreateCell(2);
HSSFCell celSum1 = row1.CreateCell(3);
HSSFCell celSum2 = row1.CreateCell(4);
HSSFCell celSum3 = row1.CreateCell(5);

cel1.SetCellValue(1);
cel2.SetCellValue(2);
cel3.SetCellValue(3);
celSum2.SetCellFormula("sum(A1,C1)");

固然，把每个单元格做为Sum函数的参数很容易理解，但若是要求和的单元格不少，那么公式就会很长，既不方便阅读也不方便书写。因此Excel提供了另一种多个单元格求和的写法：

如上图中的“Sum(A1:C1)”表示求从A1到C1全部单元格的和，至关于A1+B1+C1。
对应的代码为：

celSum1.SetCellFormula("sum(A1:C1)");

最后，还有一种求和的方法。就是先定义一个区域，如”range1”，而后再设置Sum(range1)，此时将计算区域中全部单元格的和。
定义区域的代码为：

HSSFName range = hssfworkbook.CreateName();
range.Reference = "Sheet1!$A1:$C1";
range.NameName = "range1";

执行此代码后的Excel文件将在的公式菜单下的名称管理器(Excel2007的菜单路径,2003稍有不一样)中看到以下区域定义：

给单元格F1加上公式：

celSum3.SetCellFormula("sum(range1)");

生成的Excel以下图所示：

2.3.3用NPOI操做EXCEL－－日期函数

Excel中有很是丰富的日期处理函数，在NPOI中一样获得了很好的支持。以下图：
对应的与前面的基本公式设置相似：

HSSFSheet sheet1 = hssfworkbook.CreateSheet("Sheet1");
HSSFRow row1 = sheet1.CreateRow(0);
HSSFRow row2 = sheet1.CreateRow(1);
row1.CreateCell(0).SetCellValue("姓名");
row1.CreateCell(1).SetCellValue("参加工做时间");
row1.CreateCell(2).SetCellValue("当前日期");
row1.CreateCell(3).SetCellValue("工做年限");

HSSFCell cel1 = row2.CreateCell(0);
HSSFCell cel2 = row2.CreateCell(1);
HSSFCell cel3 = row2.CreateCell(2);
HSSFCell cel4 = row2.CreateCell(3);

cel1.SetCellValue("aTao.Xiang");
cel2.SetCellValue(new DateTime(2004, 7, 1));
cel3.SetCellFormula("TODAY()");
cel4.SetCellFormula("CONCATENATE(DATEDIF(B2,TODAY(),\"y\"),\"年\",DATEDIF(B2,TODAY(),\"ym\"),\"个月\")");

//在poi中日期是以double类型表示的，因此要格式化
HSSFCellStyle cellStyle = hssfworkbook.CreateCellStyle();
HSSFDataFormat format = hssfworkbook.CreateDataFormat();
cellStyle.DataFormat = format.GetFormat("yyyy-m-d");

cel2.CellStyle = cellStyle;
cel3.CellStyle = cellStyle;

下面对上例中用到的几个主要函数做一些说明：
TODAY()：取得当前日期;
DATEDIF(B2,TODAY(),"y")：取得B2单元格的日期与前日期以年为单位的时间间隔。(“Y”:表示以年为单位,”m”表示以月为单位;”d”表示以天为单位);
CONCATENATE(str1,str2,...)：链接字符串。

另外附上Excel中经常使用的日期函数列表，只须要将此句代码做适当修改便可：

cel4.SetCellFormula("CONCATENATE(DATEDIF(B2,TODAY(),\"y\"),\"年\",DATEDIF(B2,TODAY(),\"ym\"),\"个月\")");

函数名	函数说明	语法
DATE	返回表明特定日期的系列数。	DATE(year,month,day)
DATEDIF	计算两个日期之间的天数、月数或年数。	DATEDIF(start_date,end_date,unit)
DATEVALUE	函数 DATEVALUE的主要功能是将以文字表示的日期转换成一个系列数。	DATEVALUE(date_text)
DAY	返回以系列数表示的某日期的天数，用整数 1到 31表示。	DAY(serial_number)
DAYS360	按照一年 360天的算法（每月以 30天计，一年共计 12 个月），返回两日期间相差的天数。	DAYS360(start_date,end_date,method)
EDATE	返回指定日期 (start_date)以前或以后指定月份数的日期系列数。使用函数 EDATE能够计算与发行日处于一月中同一天的到期日的日期。	EDATE(start_date,months)
EOMONTH	返回 start-date以前或以后指定月份中最后一天的系列数。用函数 EOMONTH可计算特定月份中最后一天的时间系列数，用于证券的到期日等计算。	EOMONTH(start_date,months)
HOUR	返回时间值的小时数。即一个介于 0 (12:00 A.M.)到 23 (11:00 P.M.)之间的整数。	HOUR(serial_number)
MINUTE	返回时间值中的分钟。即一个介于 0到 59之间的整数。	MINUTE(serial_number)
MONTH	返回以系列数表示的日期中的月份。月份是介于 1（一月）和 12（十二月）之间的整数。	MONTH(serial_number)
NETWORKDAYS	返回参数 start-data和 end-data之间完整的工做日数值。工做日不包括周末和专门指定的假期	NETWORKDAYS(start_date,end_date,holidays)
NOW	返回当前日期和时间所对应的系列数。	NOW( )
SECOND	返回时间值的秒数。返回的秒数为 0至 59之间的整数。	SECOND(serial_number)
TIME	返回某一特定时间的小数值，函数 TIME返回的小数值为从 0到 0.99999999 之间的数值，表明从 0:00:00 (12:00:00 A.M)到 23:59:59 (11:59:59 P.M)之间的时间。	TIME(hour,minute,second)
TIMEVALUE	返回由文本串所表明的时间的小数值。该小数值为从 0到 0.999999999的数值，表明从 0:00:00 (12:00:00 AM)到 23:59:59 (11:59:59 PM)之间的时间。	TIMEVALUE(time_text)
TODAY	返回当前日期的系列数，系列数是 Microsoft Excel用于日期和时间计算的日期-时间代码。	TODAY( )
WEEKDAY	返回某日期为星期几。默认状况下，其值为 1（星期天）到 7（星期六）之间的整数。	WEEKDAY(serial_number,return_type)
WEEKNUM	返回一个数字，该数字表明一年中的第几周。	WEEKNUM(serial_num,return_type)
WORKDAY	返回某日期（起始日期）以前或以后相隔指定工做日的某一日期的日期值。工做日不包括周末和专门指定的假日。	WORKDAY(start_date,days,holidays)
YEAR	返回某日期的年份。返回值为 1900到 9999之间的整数。	YEAR(serial_number)
YEARFRAC	返回 start_date和 end_date之间的天数占整年天数的百分比。	YEARFRAC(start_date,end_date,basis)

2.3.4用NPOI操做EXCEL－－字符串函数

      这一节咱们开始学习Excel另外一类很是常见的函数—字符串函数。在Excel中提供了很是丰富的字符串函数，在NPOI中一样获得了很好的支持。
1、大小写转换类函数
      LOWER(String)：将一个文字串中的全部大写字母转换为小写字母。
      UPPER(String)：将文本转换成大写形式。
      PROPER(String)：将文字串的首字母及任何非字母字符以后的首字母转换成大写。将其他的字母转换成小写。
      对应的C#代码与前几节讲的设置公式的代码相似：

HSSFRow row1 = sheet1.CreateRow(0);
row1.CreateCell(0).SetCellValue("待操做字符串");
row1.CreateCell(1).SetCellValue("操做函数");
row1.CreateCell(2).SetCellValue("操做结果");

HSSFRow row2 = sheet1.CreateRow(1);
row2.CreateCell(0).SetCellValue("This is a NPOI example!");
row2.CreateCell(1).SetCellValue("LOWER(A2)");
//将此句中的“LOWER(A2)”换成UPPER (A2)、PROPER (A2)能够看到不一样效果。
row2.CreateCell(2).SetCellFormula("LOWER(A2)");

2、取出字符串中的部分字符
LEFT(text,num_chars)：LEFT(text,num_chars)其中Text是包含要提取字符的文本串。Num_chars指定要由 LEFT 所提取的字符数。

MID(text,start_num,num_chars)：MID(text,start_num,num_chars)其中Text是包含要提取字符的文本串。Start_num是文本中要提取的第一个字符的位置，num_chars表示要提取的字符的数。

      RIGHT(text,num_chars)：RIGHT(text,num_chars)其中Text是包含要提取字符的文本串。Num_chars指定但愿 RIGHT 提取的字符数。
      代码与上面相似，就不写了。

3、去除字符串的空白
      TRIM(text)：其中Text为须要清除其中空格的文本。须要注意的是，与C#中的Trim不一样，Excel中的Trim函数不只会删除字符串头尾的字符，字符串中的多余字符也会删除，单词之间只会保留一个空格。

4、字符串的比较
EXACT(text1,text2)：比较两个字符串是否相等，区分大小写。

执行效果以下：

在此只简单的讲了一下经常使用的函数，Excel中还有不少的字符串函数，在此附上，读者能够一个一个去测试。

函数名	函数说明	语法
ASC	将字符串中的全角（双字节）英文字母更改成半角（单字节）字符。	ASC(text)
CHAR	返回对应于数字代码的字符，函数 CHAR可将其余类型计算机文件中的代码转换为字符。	CHAR(number)
CLEAN	删除文本中不能打印的字符。对从其余应用程序中输入的字符串使用 CLEAN函数，将删除其中含有的当前操做系统没法打印的字符。例如，能够删除一般出如今数据文件头部或尾部、没法打印的低级计算机代码。	CLEAN(text)
CODE	返回文字串中第一个字符的数字代码。返回的代码对应于计算机当前使用的字符集。	CODE(text)
CONCATENATE	将若干文字串合并到一个文字串中。	CONCATENATE (text1,text2,...)
DOLLAR	依照货币格式将小数四舍五入到指定的位数并转换成文字。	DOLLAR 或 RMB(number,decimals)
EXACT	该函数测试两个字符串是否彻底相同。若是它们彻底相同，则返回 TRUE；不然，返回 FALSE。函数 EXACT 能区分大小写，但忽略格式上的差别。利用函数 EXACT能够测试输入文档内的文字。	EXACT(text1,text2)
FIND	FIND 用于查找其余文本串 (within_text)内的文本串 (find_text)，并从 within_text的首字符开始返回 find_text的起始位置编号。	FIND(find_text,within_text,start_num)
FIXED	按指定的小数位数进行四舍五入，利用句点和逗号，以小数格式对该数设置格式，并以文字串形式返回结果。	FIXED(number,decimals,no_commas)
JIS	将字符串中的半角（单字节）英文字母或片假名更改成全角（双字节）字符。	JIS(text)
LEFT	LEFT 基于所指定的字符数返回文本串中的第一个或前几个字符。 LEFTB 基于所指定的字节数返回文本串中的第一个或前几个字符。此函数用于双字节字符。	LEFT(text,num_chars) LEFTB(text,num_bytes)
LEN	LEN 返回文本串中的字符数。 LENB 返回文本串中用于表明字符的字节数。此函数用于双字节字符。	LEN(text) LENB(text)
LOWER	将一个文字串中的全部大写字母转换为小写字母。	LOWER(text)
MID	MID 返回文本串中从指定位置开始的特定数目的字符，该数目由用户指定。 MIDB 返回文本串中从指定位置开始的特定数目的字符，该数目由用户指定。此函数用于双字节字符。	MID(text,start_num,num_chars) MIDB(text,start_num,num_bytes)
PHONETIC	提取文本串中的拼音 (furigana)字符。	PHONETIC(reference)
PROPER	将文字串的首字母及任何非字母字符以后的首字母转换成大写。将其他的字母转换成小写。	PROPER(text)
REPLACE	REPLACE 使用其余文本串并根据所指定的字符数替换某文本串中的部分文本。 REPLACEB 使用其余文本串并根据所指定的字符数替换某文本串中的部分文本。此函数专为双字节字符使用。	REPLACE(old_text,start_num,num_chars,new_text) REPLACEB(old_text,start_num,num_bytes,new_text)
REPT	按照给定的次数重复显示文本。能够经过函数 REPT来不断地重复显示某一文字串，对单元格进行填充。	REPT(text,number_times)
RIGHT	RIGHT 根据所指定的字符数返回文本串中最后一个或多个字符。 RIGHTB 根据所指定的字符数返回文本串中最后一个或多个字符。此函数用于双字节字符。	RIGHT(text,num_chars) RIGHTB(text,num_bytes)
SEARCH	SEARCH 返回从 start_num开始首次找到特定字符或文本串的位置上特定字符的编号。使用 SEARCH可肯定字符或文本串在其余文本串中的位置，这样就可以使用 MID或 REPLACE 函数更改文本。 SEARCHB 也可在其余文本串 (within_text)中查找文本串 (find_text)，并返回 find_text的起始位置编号。此结果是基于每一个字符所使用的字节数，并从 start_num开始的。此函数用于双字节字符。此外，也可以使用 FINDB在其余文本串中查找文本串。	SEARCH(find_text,within_text,start_num) SEARCHB(find_text,within_text,start_num)
SUBSTITUTE	在文字串中用 new_text替代 old_text。若是须要在某一文字串中替换指定的文本，请使用函数 SUBSTITUTE；若是须要在某一文字串中替换指定位置处的任意文本，请使用函数 REPLACE。	SUBSTITUTE(text,old_text,new_text,instance_num)
T	将数值转换成文本。	T(value)
TEXT	将一数值转换为按指定数字格式表示的文本。	TEXT(value,format_text)
TRIM	除了单词之间的单个空格外，清除文本中全部的空格。在从其余应用程序中获取带有不规则空格的文本时，可使用函数 TRIM。	TRIM(text)
UPPER	将文本转换成大写形式。	UPPER(text)
VALUE	将表明数字的文字串转换成数字。	VALUE(text)
WIDECHAR	将单字节字符转换为双字节字符。	WIDECHAR(text)
YEN	使用￥（日圆）货币格式将数字转换成文本，并对指定位置后的数字四舍五入。	YEN(number,decimals)

2.3.5用NPOI操做EXCEL－－If函数

在Excel中,IF(logical_test,value_if_true,value_if_false)用来用做逻辑判断。其中Logical_test表示计算结果为 TRUE 或 FALSE 的任意值或表达式 ; value_if_true表示当表达式Logical_test的值为TRUE时的返回值；value_if_false表示当表达式Logical_test的值为FALSE时的返回值。一样在NPOI中也能够利用这个表达式进行各类逻辑运算。以下代码分别设置了B2和D2单元格的用于逻辑判断的公式。

HSSFSheet sheet1 = hssfworkbook.CreateSheet("Sheet1");

HSSFRow row1 = sheet1.CreateRow(0);
row1.CreateCell(0).SetCellValue("姓名");
row1.CreateCell(1).SetCellValue("身份证号");
row1.CreateCell(2).SetCellValue("性别");
row1.CreateCell(3).SetCellValue("语文");
row1.CreateCell(4).SetCellValue("是否合格");

HSSFRow row2 = sheet1.CreateRow(1);
row2.CreateCell(0).SetCellValue("令狐冲");
row2.CreateCell(1).SetCellValue("420821198808101014");
row2.CreateCell(2).SetCellFormula("IF(MOD(MID(B2,18,1),2)=0,\"男\",\"女\")");
row2.CreateCell(3).SetCellValue(85);
row2.CreateCell(4).SetCellFormula("IF(D2>60,IF(D2>90,\"优秀\",\"合格\"),\"不合格\")");

其中最关键的两句执行结果以下：

row2.CreateCell(2).SetCellFormula("IF(MOD(MID(B2,18,1),2)=0,\"男\",\"女\")");

row2.CreateCell(4).SetCellFormula("IF(D2>60,IF(D2>90,\"优秀\",\"合格\"),\"不合格\")");

下面分别对这几个函数做一些说明：
MOD(MID(B2,18,1),2)：咱们知道18位身份证号的第18位表示性别，偶数为男性，奇数为女性，因此用了MID(B2,18,1)取第18位数字（与C#中通常从0计数不一样，第二个参数是从1算起，有关MID函数的更多信息，请参见字符串函数），用MOD取余函数判断奇偶。在Excel中对数据类型的控制没有C#中那么严格，如此例中我截取出来的是字符串，但当我作取余运算时Excel会自动转换。
IF(D2>60,IF(D2>90,"优秀","合格"),"不合格")：这是IF的嵌套使用，表示90分以上为优秀，60分以上为合格，不然为不合格。

2.3.6用NPOI操做EXCEL－－COUNTIF和SUMIF函数

1、COUNTIF
这一节，咱们一块儿来学习Excel中另外一个经常使用的函数--COUNTIF函数，看函数名就知道这是一个用来在作知足某条件的计数的函数。先来看一看它的语法：COUNTIF(range,criteria)，参数说明以下：

Range	须要进行读数的计数
Criteria	条件表达式，只有当知足此条件时才进行计数

接下来看一个例子，代码以下：

HSSFSheet sheet1 = hssfworkbook.CreateSheet("Sheet1");

HSSFRow row1 = sheet1.CreateRow(0);
row1.CreateCell(0).SetCellValue("姓名");
row1.CreateCell(1).SetCellValue("成绩");

HSSFRow row2 = sheet1.CreateRow(1);
row2.CreateCell(0).SetCellValue("令狐冲");
row2.CreateCell(1).SetCellValue(85);

HSSFRow row3 = sheet1.CreateRow(2);
row3.CreateCell(0).SetCellValue("任盈盈");
row3.CreateCell(1).SetCellValue(90);

HSSFRow row4 = sheet1.CreateRow(3);
row4.CreateCell(0).SetCellValue("任我行");
row4.CreateCell(1).SetCellValue(70);

HSSFRow row5 = sheet1.CreateRow(4);
row5.CreateCell(0).SetCellValue("左冷婵");
row5.CreateCell(1).SetCellValue(45);

HSSFRow row6 = sheet1.CreateRow(5);
row6.CreateCell(0).SetCellValue("岳不群");
row6.CreateCell(1).SetCellValue(50);

HSSFRow row7 = sheet1.CreateRow(6);
row7.CreateCell(0).SetCellValue("合格人数：");
row7.CreateCell(1).SetCellFormula("COUNTIF(B2:B6,\">60\")");

执行结果以下：

咱们能够看到，CountIf函数成功的统计出了区域“B2：B6”中成绩合格的人数（这里定义成绩大于60为合格）。

2、SUMIF

接下来，顺便谈谈另外一个与CountIF相似的函数—SumIf函数。此函数用于统计某区域内知足某条件的值的求和(CountIf是计数)。与CountIF不一样，SumIF有三个参数，语法为SumIF(criteria_range, criteria,sum_range)，各参数的说明以下：

criteria_range	条件测试区域，第二个参数Criteria中的条件将与此区域中的值进行比较
criteria	条件测试值，知足条件的对应的sum_range项将进行求和计算
sum_range	汇总数据所在区域，求和时会排除掉不知足Criteria条件的对应的项

咱们仍是以例子来加以说明：

Code
HSSFSheet sheet1 = hssfworkbook.CreateSheet("Sheet1");

HSSFRow row1 = sheet1.CreateRow(0);
row1.CreateCell(0).SetCellValue("姓名");
row1.CreateCell(1).SetCellValue("月份");
row1.CreateCell(2).SetCellValue("销售额");

HSSFRow row2 = sheet1.CreateRow(1);
row2.CreateCell(0).SetCellValue("令狐冲");
row2.CreateCell(1).SetCellValue("一月");
row2.CreateCell(2).SetCellValue(1000);

HSSFRow row3 = sheet1.CreateRow(2);
row3.CreateCell(0).SetCellValue("任盈盈");
row3.CreateCell(1).SetCellValue("一月");
row3.CreateCell(2).SetCellValue(900);

HSSFRow row4 = sheet1.CreateRow(3);
row4.CreateCell(0).SetCellValue("令狐冲");
row4.CreateCell(1).SetCellValue("二月");
row4.CreateCell(2).SetCellValue(2000);

HSSFRow row5 = sheet1.CreateRow(4);
row5.CreateCell(0).SetCellValue("任盈盈");
row5.CreateCell(1).SetCellValue("二月");
row5.CreateCell(2).SetCellValue(1000);

HSSFRow row6 = sheet1.CreateRow(5);
row6.CreateCell(0).SetCellValue("令狐冲");
row6.CreateCell(1).SetCellValue("三月");
row6.CreateCell(2).SetCellValue(3000);

HSSFRow row7 = sheet1.CreateRow(6);
row7.CreateCell(0).SetCellValue("任盈盈");
row7.CreateCell(1).SetCellValue("三月");
row7.CreateCell(2).SetCellValue(1200);

HSSFRow row8 = sheet1.CreateRow(7);
row8.CreateCell(0).SetCellValue("令狐冲一季度销售额：");
row8.CreateCell(2).SetCellFormula("SUMIF(A2:A7,\"=令狐冲\",C2:C7)");

HSSFRow row9 = sheet1.CreateRow(8);
row9.CreateCell(0).SetCellValue("任盈盈一季度销售额：");
row9.CreateCell(2).SetCellFormula("SUMIF(A2:A7,\"=任盈盈\",C2:C7)");

执行结果以下：

如上图，SUMIF统计出了不一样人一季度的销售额。

2.3.7用NPOI操做EXCEL－－LOOKUP函数

今天，咱们一块儿学习Excel中的查询函数－－LOOKUP。其基本语法形式为LOOKUP(lookup_value,lookup_vector,result_vector)。仍是以例子加以说明更容易理解：

Code
HSSFSheet sheet1 = hssfworkbook.CreateSheet("Sheet1");
HSSFRow row1 = sheet1.CreateRow(0);
row1.CreateCell(0).SetCellValue("收入最低");
row1.CreateCell(1).SetCellValue("收入最高");
row1.CreateCell(2).SetCellValue("税率");

HSSFRow row2 = sheet1.CreateRow(1);
row2.CreateCell(0).SetCellValue(0);
row2.CreateCell(1).SetCellValue(3000);
row2.CreateCell(2).SetCellValue(0.1);

HSSFRow row3 = sheet1.CreateRow(2);
row3.CreateCell(0).SetCellValue(3001);
row3.CreateCell(1).SetCellValue(10000);
row3.CreateCell(2).SetCellValue(0.2);

HSSFRow row4 = sheet1.CreateRow(3);
row4.CreateCell(0).SetCellValue(10001);
row4.CreateCell(1).SetCellValue(20000);
row4.CreateCell(2).SetCellValue(0.3);

HSSFRow row5 = sheet1.CreateRow(4);
row5.CreateCell(0).SetCellValue(20001);
row5.CreateCell(1).SetCellValue(50000);
row5.CreateCell(2).SetCellValue(0.4);

HSSFRow row6 = sheet1.CreateRow(5);
row6.CreateCell(0).SetCellValue(50001);
row6.CreateCell(2).SetCellValue(0.5);

HSSFRow row8 = sheet1.CreateRow(7);
row8.CreateCell(0).SetCellValue("收入");
row8.CreateCell(1).SetCellValue("税率");

HSSFRow row9 = sheet1.CreateRow(8);
row9.CreateCell(0).SetCellValue(7800);
row9.CreateCell(1).SetCellFormula("LOOKUP(A9,$A$2:$A$6,$C$2:$C$6)");

这是一个根据工资查询相应税率的例子。咱们首先建立了不一样工资区间对应税率的字典，而后根据具体的工资在字典中找出对应的税率。执行后生成的Excel以下：

下面对各参数加以说明：
第一个参数：须要查找的内容，本例中指向A9单元格，也就是7800；
第二个参数：比较对象区域，本例中的工资须要与$A$2:$A$6中的各单元格中的值进行比较；第三个参数：查找结果区域，若是匹配到会将此区域中对应的数据返回。如本例中返回$C$2:$C$6中对应的值。
可能有人会问，字典中没有7800对应的税率啊，那么Excel中怎么匹配的呢？答案是模糊匹配，而且LOOKUP函数只支持模糊匹配。Excel会在$A$2:$A$6中找小于7800的最大值，也就是A3对应的3001，而后将对应的$C$2:$C$6区域中的C3中的值返回，这就是最终结果0.2的由来。这下明白了吧：）

VLOOKUP
另外，LOOKUP函数还有一位大哥－－VLOOKUP。两兄弟有不少类似之处，但大哥本领更大。Vlookup用对比数与一个“表”进行对比，而不是Lookup函数的某1列或1行，而且Vlookup能够选择采用精确查询或是模糊查询方式，而Lookup只有模糊查询。
将上例中设置公式的代码换成：

row9.CreateCell(1).SetCellFormula("VLOOKUP(A9,$A$2:$C$6,3,TRUE)");

执行后生成的Excel样式以下：

第一个参数：须要查找的内容，这里是A9单元格；
第二个参数：须要比较的表，这里是$A$2:$C$6，注意VLOOKUP匹配时只与表中的第一列进行匹配。
第三个参数：匹配结果对应的列序号。这里要对应的是税率列，因此为3。
第四个参数：指明是否模糊匹配。例子中的TRUE表示模糊匹配，与上例中同样。匹配到的是第三行。若是将此参数改成FALSE，由于在表中的第1列中找不到7800，因此会报“#N/A”的计算错误。

另外，还有与VLOKUP相似的HLOOKUP。不一样的是VLOOKUP用于在表格或数值数组的首列查找指定的数值，并由此返回表格或数组当前行中指定列处的数值。而HLOOKUP用于在表格或数值数组的首行查找指定的数值，并由此返回表格或数组当前列中指定行处的数值。读者能够自已去尝试。

2.3.8用NPOI操做EXCEL－－随机数函数

咱们知道，在大多数编程语言中都有随机数函数。在Excel中，一样存在着这样一个函数—RAND()函数，用于生成随机数。先来看一个最简单的例子：

HSSFSheet sheet1 = hssfworkbook.CreateSheet("Sheet1");
sheet1.CreateRow(0).CreateCell(0).SetCellFormula("RAND()");

RAND()函数将返回一个0-1之间的随机数，执行后生成的Excel文件以下：

这只是最简单直接的RAND()函数的应用，只要咱们稍加修改，就能够做出不少种变换。如
取0-100以前的随机整数，可设置公式为：

sheet1.CreateRow(0).CreateCell(0).SetCellFormula("int(RAND()*100)");

取10-20之间的随机实数，可设置公式为：

sheet1.CreateRow(0).CreateCell(0).SetCellFormula("rand()*(20-10)+10");

随机小写字母：

sheet1.CreateRow(0).CreateCell(0).SetCellFormula("CHAR(INT(RAND()*26)+97)");

随机大写字母：

sheet1.CreateRow(0).CreateCell(0).SetCellFormula("CHAR(INT(RAND()*26)+65)")

随机大小写字母：

sheet1.CreateRow(0).CreateCell(0).SetCellFormula("CHAR(INT(RAND()*26)+if(INT(RAND()*2)=0,65,97))");

上面几例中除了用到RAND函数之外，还用到了CHAR函数用来将ASCII码换为字母，INT函数用来取整。值得注意的是INT函数不会四舍五入，不管小数点后是多少都会被舍去。
这里只是RAND函数的几个简单应用，还有不少随机数的例子均可以根据这些，再结合不一样的其它函数引伸出来。

2.3.9用NPOI操做EXCEL－－经过NPOI得到公式的返回值

前面咱们学习了经过NPOI向Excel中设置公式，那么有些读者可能会问：“NPOI能不能获取公式的返回值呢？”，答案是能够！
1、获取模板文件中公式的返回值
如在D盘中有一个名为text.xls的Excel文件，其内容以下：

注意C1单元格中设置的是公式“$A1*$B1”，而不是值“12”。利用NPOI，只须要写简单的几句代码就能够取得此公式的返回值：

HSSFWorkbook wb = new HSSFWorkbook(new FileStream("d:/test.xls",FileMode.Open));
HSSFCell cell = wb.GetSheet("Sheet1").GetRow(0).GetCell(2);
System.Console.WriteLine(cell.NumericCellValue);

输出结果为：

可见NPOI成功的“解析”了此.xls文件中的公式。注意NumericCellValue属性会自动根据单元格的类型处理，若是为空将返0，若是为数值将返回数值，若是为公式将返回公式计算后的结果。单元格的类型能够经过CellType属性获取。

2、获取NPOI生成的Excel文件中公式的返回值
上例中是从一个已经存在的Excel文件中获取公式的返回值，那么若是Excel文件是经过NPOI建立的，直接用上面的方法获取，可能得不到想要的结果。如：

1 HSSFWorkbook hssfworkbook = new HSSFWorkbook();
2 HSSFSheet sheet1 = hssfworkbook.CreateSheet("Sheet1");
3 HSSFRow row = sheet1.CreateRow(0);
4 row.CreateCell(0).SetCellValue(3);
5 row.CreateCell(1).SetCellValue(4);
6 HSSFCell cell = row.CreateCell(2);
7
8 cell.SetCellFormula("$A1+$B1");
9 System.Console.WriteLine(cell.NumericCellValue);

执行上面代码，将输出结果“0”，而不是咱们想要的结果“7”。那么将如何解决呢？这时要用到HSSFFormulaEvaluator类。在第8行后加上这两句就能够了：

HSSFFormulaEvaluator e = new HSSFFormulaEvaluator(hssfworkbook);
cell = e.EvaluateInCell(cell);

运行结果以下：

2.4.1用NPOI操做EXCEL－－画线

之全部说NPOI强大，是由于经常使用的Excel操做她均可以经过编程的方式完成。这节开始，咱们开始学习NPOI的画图功能。先从最简单的开始，画一条直线：

对应的代码为：

HSSFSheet sheet1 = hssfworkbook.CreateSheet("Sheet1");
HSSFPatriarch patriarch = sheet1.CreateDrawingPatriarch();
HSSFClientAnchor a1 = new HSSFClientAnchor(255, 125, 1023, 150, 0, 0,2, 2);
HSSFSimpleShape line1 = patriarch.CreateSimpleShape(a1);

line1.ShapeType = HSSFSimpleShape.OBJECT_TYPE_LINE;
line1.LineStyle = HSSFShape.LINESTYLE_SOLID;
//在NPOI中线的宽度12700表示1pt,因此这里是0.5pt粗的线条。
line1.LineWidth = 6350;

一般，利用NPOI画图主要有如下几个步骤：
1. 建立一个Patriarch；
2. 建立一个Anchor，以肯定图形的位置；
3. 调用Patriarch建立图形；
4. 设置图形类型(直线，矩形，圆形等)及样式（颜色，粗细等）。

关于HSSFClientAnchor(dx1,dy1,dx2,dy2,col1,row1,col2,row2)的参数，有必要在这里说明一下：
dx1：起始单元格的x偏移量，如例子中的255表示直线起始位置距A1单元格左侧的距离；
dy1：起始单元格的y偏移量，如例子中的125表示直线起始位置距A1单元格上侧的距离；
dx2：终止单元格的x偏移量，如例子中的1023表示直线起始位置距C3单元格左侧的距离；
dy2：终止单元格的y偏移量，如例子中的150表示直线起始位置距C3单元格上侧的距离；
col1：起始单元格列序号，从0开始计算；
row1：起始单元格行序号，从0开始计算，如例子中col1=0,row1=0就表示起始单元格为A1；
col2：终止单元格列序号，从0开始计算；
row2：终止单元格行序号，从0开始计算，如例子中col2=2,row2=2就表示起始单元格为C3；

最后，关于LineStyle属性，有以下一些可选值，对应的效果分别如图所示：

2.4.2用NPOI操做EXCEL－－画矩形

上一节咱们讲了NPOI中画图的基本步骤：
1. 建立一个Patriarch；
2. 建立一个Anchor，以肯定图形的位置；
3. 调用Patriarch建立图形；
4. 设置图形类型(直线，矩形，圆形等)及样式（颜色，粗细等）。

这一节咱们将按照这个步骤建立一个矩形。废话少说，上代码：

HSSFSheet sheet1 = hssfworkbook.CreateSheet("Sheet1");
HSSFPatriarch patriarch = sheet1.CreateDrawingPatriarch();
HSSFClientAnchor a1 = new HSSFClientAnchor(255, 125, 1023, 150, 0, 0, 2, 2);
HSSFSimpleShape rec1 = patriarch.CreateSimpleShape(a1);
//此处设置图形类型为矩形
rec1.ShapeType = HSSFSimpleShape.OBJECT_TYPE_RECTANGLE;
//设置填充色
rec1.SetFillColor(125, 125, 125);
//设置边框样式
rec1.LineStyle = HSSFShape.LINESTYLE_DASHGEL;
//设置边框宽度
rec1.LineWidth = 25400;
//设置边框颜色
rec1.SetLineStyleColor(100, 0, 100);

代码执行效果：

其中SetFillColor和SetLineStyleColor函数的三个参数分别是RGB三色值，具体表示什么颜色，找个Photoshop试试：）
关于HSSFClientAnchor参数说明、边框样式，边框宽度的说明能够参见前一篇博文：
http://www.cnblogs.com/atao/archive/2009/09/13/1565645.html

2.4.3用NPOI操做EXCEL－－画圆形

前面咱们学习了NPOI中的画简单直线和矩形的功能，今天咱们一块儿学习一下它支持的另外一种简单图形－－圆形。一样，按照前面所讲的绘图“四步曲”：
1. 建立一个Patriarch；
2. 建立一个Anchor，以肯定图形的位置；
3. 调用Patriarch建立图形；
4. 设置图形类型(直线，矩形，圆形等)及样式（颜色，粗细等）。
仍是以例子加以说明：

HSSFSheet sheet1 = hssfworkbook.CreateSheet("Sheet1");
HSSFPatriarch patriarch = sheet1.CreateDrawingPatriarch();
HSSFClientAnchor a1 = new HSSFClientAnchor(0, 0, 1023, 0, 0, 0, 1, 3);
HSSFSimpleShape rec1 = patriarch.CreateSimpleShape(a1);
rec1.ShapeType = HSSFSimpleShape.OBJECT_TYPE_OVAL;

rec1.SetFillColor(125, 125, 125);
rec1.LineStyle = HSSFShape.LINESTYLE_DASHGEL;
rec1.LineWidth = 12700;
rec1.SetLineStyleColor(100, 0, 100);
WriteToFile();

这里rec1.ShapeType =HSSFSimpleShape.OBJECT_TYPE_OVAL;表示图形为椭圆。适当调整HSSFClientAnchor的各参数能够获得圆形。
关于HSSFClientAnchor构造函数和边框、填充色等前两节都有介绍，这里再也不重述。详情情见：画矩形和画线。

上面代码执行生成的Excel以下：

2.4.4用NPOI操做EXCEL－－画Grid

　　在NPOI中，自己没有画Grid的方法。但咱们知道Grid其实就是由横线和竖线构成的，所在咱们能够经过画线的方式来模拟画Grid。

HSSFSheet sheet1 = hssfworkbook.CreateSheet("Sheet1");

HSSFRow row = sheet1.CreateRow(2);
row.CreateCell(1);
row.HeightInPoints = 240;
sheet1.SetColumnWidth(2, 9000);
int linesCount = 20;

HSSFPatriarch patriarch = sheet1.CreateDrawingPatriarch();
//由于HSSFClientAnchor中dx只能在0-1023之间,dy只能在0-255之间，因此这里采用比例的方式
double xRatio = 1023.0 / (linesCount*10);
double yRatio = 255.0 / (linesCount*10);

//画竖线
int x1 = 0;
int y1 = 0;
int x2 = 0;
int y2 = 200;
for (int i = 0; i < linesCount; i++)
{
    HSSFClientAnchor a2 = new HSSFClientAnchor();
    a2.SetAnchor((short)2, 2, (int)(x1 * xRatio), (int)(y1 * yRatio),
            (short)2, 2, (int)(x2 * xRatio), (int)(y2 * yRatio));
    HSSFSimpleShape shape2 = patriarch.CreateSimpleShape(a2);
    shape2.ShapeType = (HSSFSimpleShape.OBJECT_TYPE_LINE);

    x1 += 10;
    x2 += 10;
}

//画横线
x1 = 0;
y1 = 0;
x2 = 200;
y2 = 0;
for (int i = 0; i < linesCount; i++)
{
    HSSFClientAnchor a2 = new HSSFClientAnchor();
    a2.SetAnchor((short)2, 2, (int)(x1 * xRatio), (int)(y1 * yRatio),
            (short)2, 2, (int)(x2 * xRatio), (int)(y2 * yRatio));
    HSSFSimpleShape shape2 = patriarch.CreateSimpleShape(a2);
    shape2.ShapeType = (HSSFSimpleShape.OBJECT_TYPE_LINE);

    y1 += 10;
    y2 += 10;
}

请注意HSSFClientAnchor对象中的dx只能取0-1023之间的数，dy只能取0-255之间的数。咱们能够理解为是将单元格的宽和高平分红了1023和255份，设置dx和dy时至关于按比例取对应的座标。最终生成的Excel以下：

2.4.5用NPOI操做EXCEL－－插入图片

咱们知道，在Excel中是能够插入图片的。操做菜单是“插入－>图片”，而后选择要插入图片，能够很容易地在Excel插入图片。一样，在NPOI中，利用代码也能够实现一样的效果。在NPOI中插入图片的方法与画图的方法有点相似：

//add picture data to this workbook.
byte[] bytes = System.IO.File.ReadAllBytes(@"D:\MyProject\NPOIDemo\ShapeImage\image1.jpg");
int pictureIdx = hssfworkbook.AddPicture(bytes, HSSFWorkbook.PICTURE_TYPE_JPEG);

//create sheet
HSSFSheet sheet = hssfworkbook.CreateSheet("Sheet1");

// Create the drawing patriarch. This is the top level container for all shapes.
HSSFPatriarch patriarch = sheet.CreateDrawingPatriarch();

//add a picture
HSSFClientAnchor anchor = new HSSFClientAnchor(0, 0, 1023, 0, 0, 0, 1, 3);
HSSFPicture pict = patriarch.CreatePicture(anchor, pictureIdx);

与画简单图形不一样的是，首先要将图片读入到byte数组，而后添加到workbook中；最后调用的是patriarch.CreatePicture(anchor, pictureIdx)方法显示图片，而不是patriarch.CreateSimpleShape(anchor)方法。上面这段代码执行后生成的Excel文件样式以下：

咱们发现，插入的图片被拉伸填充在HSSFClientAnchor指定的区域。有时可能咱们并不须要拉伸的效果，怎么办呢？很简单，在最后加上这样一句用来自动调节图片大小：

pict.Resize();

添加代码后再执行上述代码，生成的Excel样式以下：

图片已经自动伸缩到原始大小了。

NPOI 1.2教程 - 2.5 打印相关设置

做者：Tony Qu

NPOI官方网站：http://npoi.codeplex.com/

打印设置主要包括方向设置、缩放、纸张设置、页边距等。NPOI 1.2支持大部分打印属性，可以让你轻松知足客户的打印须要。

首先是方向设置，Excel支持两种页面方向，即纵向和横向。

在NPOI中如何设置呢？你能够经过HSSFSheet.PrintSetup.Landscape来设置，Landscape是布尔类型的，在英语中是横向的意思。若是Landscape等于true，则表示页面方向为横向；不然为纵向。

接着是缩放设置，

这里的缩放比例对应于HSSFSheet.PrintSetup.Scale，而页宽和页高分别对应于HSSFSheet.PrintSetup.FitWidth和HSSFSheet.PrintSetup.FitHeight。要注意的是，这里的PrintSetup.Scale应该被设置为0-100之间的值，而不是小数。

接下来就是纸张设置了，对应于HSSFSheet.PrintSetup.PaperSize，但这里的PaperSize并非随便设置的，而是由一些固定的值决定的，具体的值与对应的纸张以下表所示：

值	纸张
1	US Letter 8 1/2 x 11 in
2	US Letter Small 8 1/2 x 11 in
3	US Tabloid 11 x 17 in
4	US Ledger 17 x 11 in
5	US Legal 8 1/2 x 14 in
6	US Statement 5 1/2 x 8 1/2 in
7	US Executive 7 1/4 x 10 1/2 in
8	A3 297 x 420 mm
9	A4 210 x 297 mm
10	A4 Small 210 x 297 mm
11	A5 148 x 210 mm
12	B4 (JIS) 250 x 354
13	B5 (JIS) 182 x 257 mm
14	Folio 8 1/2 x 13 in
15	Quarto 215 x 275 mm
16	10 x 14 in
17	11 x 17 in
18	US Note 8 1/2 x 11 in
19	US Envelope #9 3 7/8 x 8 7/8
20	US Envelope #10 4 1/8 x 9 1/2
21	US Envelope #11 4 1/2 x 10 3/8
22	US Envelope #12 4 \276 x 11
23	US Envelope #14 5 x 11 1/2
24	C size sheet
25	D size sheet
26	E size sheet
27	Envelope DL 110 x 220mm
28	Envelope C5 162 x 229 mm
29	Envelope C3 324 x 458 mm
30	Envelope C4 229 x 324 mm
31	Envelope C6 114 x 162 mm
32	Envelope C65 114 x 229 mm
33	Envelope B4 250 x 353 mm
34	Envelope B5 176 x 250 mm
35	Envelope B6 176 x 125 mm
36	Envelope 110 x 230 mm
37	US Envelope Monarch 3.875 x 7.5 in
38	6 3/4 US Envelope 3 5/8 x 6 1/2 in
39	US Std Fanfold 14 7/8 x 11 in
40	German Std Fanfold 8 1/2 x 12 in
41	German Legal Fanfold 8 1/2 x 13 in
42	B4 (ISO) 250 x 353 mm
43	Japanese Postcard 100 x 148 mm
44	9 x 11 in
45	10 x 11 in
46	15 x 11 in
47	Envelope Invite 220 x 220 mm
48	RESERVED--DO NOT USE
49	RESERVED--DO NOT USE
50	US Letter Extra 9 \275 x 12 in
51	US Legal Extra 9 \275 x 15 in
52	US Tabloid Extra 11.69 x 18 in
53	A4 Extra 9.27 x 12.69 in
54	Letter Transverse 8 \275 x 11 in
55	A4 Transverse 210 x 297 mm
56	Letter Extra Transverse 9\275 x 12 in
57	SuperA/SuperA/A4 227 x 356 mm
58	SuperB/SuperB/A3 305 x 487 mm
59	US Letter Plus 8.5 x 12.69 in
60	A4 Plus 210 x 330 mm
61	A5 Transverse 148 x 210 mm
62	B5 (JIS) Transverse 182 x 257 mm
63	A3 Extra 322 x 445 mm
64	A5 Extra 174 x 235 mm
65	B5 (ISO) Extra 201 x 276 mm
66	A2 420 x 594 mm
67	A3 Transverse 297 x 420 mm
68	A3 Extra Transverse 322 x 445 mm
69	Japanese Double Postcard 200 x 148 mm
70	A6 105 x 148 mm
71	Japanese Envelope Kaku #2
72	Japanese Envelope Kaku #3
73	Japanese Envelope Chou #3
74	Japanese Envelope Chou #4
75	Letter Rotated 11 x 8 1/2 11 in
76	A3 Rotated 420 x 297 mm
77	A4 Rotated 297 x 210 mm
78	A5 Rotated 210 x 148 mm
79	B4 (JIS) Rotated 364 x 257 mm
80	B5 (JIS) Rotated 257 x 182 mm
81	Japanese Postcard Rotated 148 x 100 mm
82	Double Japanese Postcard Rotated 148 x 200 mm
83	A6 Rotated 148 x 105 mm
84	Japanese Envelope Kaku #2 Rotated
85	Japanese Envelope Kaku #3 Rotated
86	Japanese Envelope Chou #3 Rotated
87	Japanese Envelope Chou #4 Rotated
88	B6 (JIS) 128 x 182 mm
89	B6 (JIS) Rotated 182 x 128 mm
90	12 x 11 in
91	Japanese Envelope You #4
92	Japanese Envelope You #4 Rotated
93	PRC 16K 146 x 215 mm
94	PRC 32K 97 x 151 mm
95	PRC 32K(Big) 97 x 151 mm
96	PRC Envelope #1 102 x 165 mm
97	PRC Envelope #2 102 x 176 mm
98	PRC Envelope #3 125 x 176 mm
99	PRC Envelope #4 110 x 208 mm
100	PRC Envelope #5 110 x 220 mm
101	PRC Envelope #6 120 x 230 mm
102	PRC Envelope #7 160 x 230 mm
103	PRC Envelope #8 120 x 309 mm
104	PRC Envelope #9 229 x 324 mm
105	PRC Envelope #10 324 x 458 mm
106	PRC 16K Rotated
107	PRC 32K Rotated
108	PRC 32K(Big) Rotated
109	PRC Envelope #1 Rotated 165 x 102 mm
110	PRC Envelope #2 Rotated 176 x 102 mm
111	PRC Envelope #3 Rotated 176 x 125 mm
112	PRC Envelope #4 Rotated 208 x 110 mm
113	PRC Envelope #5 Rotated 220 x 110 mm
114	PRC Envelope #6 Rotated 230 x 120 mm
115	PRC Envelope #7 Rotated 230 x 160 mm
116	PRC Envelope #8 Rotated 309 x 120 mm
117	PRC Envelope #9 Rotated 324 x 229 mm
118	PRC Envelope #10 Rotated 458 x 324 mm

（此表摘自《Excel Binary File Format (.xls) Structure Specification.pdf》）

HSSFSheet下面定义了一些xxxx_PAPERSIZE的常量，但都是很是经常使用的纸张大小，若是知足不了你的须要，能够根据上表本身给PaperSize属性赋值。因此，若是你要设置纸张大小能够用这样的代码：

HSSFSheet.PrintSetup.PaperSize=HSSFSheet.A4_PAPERSIZE;

或

HSSFSheet.PrintSetup.PaperSize=9;(A4 210*297mm)

再下来就是打印的起始页码，它对应于HSSFSheet.PrintSetup.PageStart和HSSFSheet.PrintSetup.UsePage，若是UsePage=false，那么就至关于“自动”，这时PageStart不起做用；若是UsePage=true，PageStart才会起做用。因此在设置PageStart以前，必须先把UsePage设置为true。

“打印”栏中的“网格线”设置对应于HSSFSheet.IsPrintGridlines，请注意，这里不是HSSFSheet.PrintSetup下面，因此别搞混了。这里之因此不隶属于PrintSetup是由底层存储该信息的record决定的，底层是把IsGridsPrinted放在GridsetRecord里面的，而不是PrintSetupRecord里面的，尽管界面上是放在一块儿的。另外还有一个HSSFSheet.IsGridsPrinted属性，这个属性对应于底层的gridset Record，但这个record是保留的，从微软的文档显示没有任何意义，因此这个属性请不要去设置。

“单色打印”则对应于HSSFSheet.PrintSetup.NoColors，这是布尔类型的，值为true时，表示单色打印。

“草稿品质”对应于HSSFSheet.PrintSetup.IsDraft，也是布尔类型的，值为true时，表示用草稿品质打印。

这里的打印顺序是由HSSFSheet.PrintSetup.LeftToRight决定的，它是布尔类型的，当为true时，则表示“先行后列”；若是是false，则表示“先列后行”。

在NPOI 1.2中，“行号列标”、“批注”和“错误单元格打印为”、“页边距”暂不支持，将在之后的版本中支持。

有关打印的范例能够参考NPOI 1.2正式版中的 SetPrintSettingsInXls项目。

2.6.1用NPOI操做EXCEL－－调整表单显示比例

在Excel中，能够经过调整右下角的滚动条来调整Sheet的显示比例。如图：

在NPOI中，也能经过代码实现这样的功能，而且代码很是简单：

HSSFSheet sheet1 = hssfworkbook.CreateSheet("Sheet1");
sheet1.CreateRow(0).CreateCell(0).SetCellValue("This is a test.");
//50% zoom
sheet1.SetZoom(1,2);

咱们发现，SetZoom有两个参数。其中第一个参数表示缩放比例的分子，第二个参数表示缩放比例的分母，因此SetZoom(1,2)就表示缩小到1/2，也就是50%。代码执行后生成的Excel样式以下：

若是将SetZoom的参数改为(2,1)，代码执行后生成的Excel样式以下，表示扩大两倍：

2.6.2用NPOI操做EXCEL－－设置密码

有时，咱们可能须要某些单元格只读，如在作模板时，模板中的数据是不能随意让别人改的。在Excel中，能够经过“审阅->保护工做表”来完成，以下图：

那么，在NPOI中有没有办法经过编码的方式达到这一效果呢？答案是确定的。

HSSFSheet sheet1 = hssfworkbook.CreateSheet("Sheet1");

HSSFRow row1 = sheet1.CreateRow(0);
HSSFCell cel1 = row1.CreateCell(0);
HSSFCell cel2 = row1.CreateCell(1);

HSSFCellStyle unlocked = hssfworkbook.CreateCellStyle();
unlocked.IsLocked = false;

HSSFCellStyle locked = hssfworkbook.CreateCellStyle();
locked.IsLocked = true;

cel1.SetCellValue("没被锁定");
cel1.CellStyle = unlocked;

cel2.SetCellValue("被锁定");
cel2.CellStyle = locked;

sheet1.ProtectSheet("password");

正如代码中所看到的，咱们经过设置CellStype的ISLocked为True，表示此单元格将被锁定。至关于在Excel中执行了以下操做：

而后经过ProtectSheet设置密码。

执行结果以下：

没被锁定的列能够任意修改。

被锁定的列不能修改。

输入密码能够解除锁定。

NPOI 1.2教程 - 组合行、列

做者：Tony Qu

NPOI官方网站：http://npoi.codeplex.com/

Excel 2007中有一个面板是专门用于设置组合功能的，叫作“分级显示”面板，以下所示：

可能咱们在过去生成Excel文件的时候根本不会用这个功能，也没办法用，由于cvs法和html法没办法控制这些东西。这里简单的介绍一下什么叫作组合：

组合分为行组合和列组合，所谓行组合，就是让n行组合成一个集合，可以进行展开和合拢操做，在Excel中显示以下：

图中左侧就是用于控制行组合折叠的图标，图中上部就是用于控制列组合的，是否是有点像TreeView中的折叠节点？不少时候因为数据太多，为了让用户对于大量数据一目了然，咱们可使用行列组合来解决显示大纲，这和Visual Studio 里面的region的概念是相似的。

细心的朋友可能已经注意到了，咱们其实能够对一行作屡次组合操做，这就是分级显示的概念，图中就把行2-3分为2个组合，第2行到第4行为一个组合，第2行到第5行一个组合，因此是分两级。

在NPOI中，要实现分组其实并不难，你只须要调用HSSFSheet.GroupRow和HSSFSheet.GroupColumn这两个方法就能够了。

首先咱们来看HSSFSheet.GroupRow，GroupRow有2个参数，分别是fromRow和toRow，表示起始行号和结束行号，这些行号都是从0开始算起的。

HSSFWorkbookhssfworkbook =newHSSFWorkbook();

HSSFSheet s =hssfworkbook.CreateSheet("Sheet1");

s.GroupRow(1,3);

上面的代码把第2行到第4行作了组合。

要组合列，其实代码很类似，以下所示：

s.GroupColumn(1,3)

上面的代码把B至D列作了组合。

正如上图中Excel的“分级显示”面板所示，有“组合”，也必定有“取消组合”，NPOI中你能够用HSSFSheet.UngroupRow和HSSFSheet.UngroupColumn，参数和GroupXXX是同样的，若是要取消第2到第4行的组合，就能够用下面的代码：

s.UngroupColumn(1,3)

相关范例请见NPOI 1.2正式版中的GroupRowAndColumnInXls项目。

2.6.4用NPOI操做EXCEL－－锁定列

在Excel中，有时可能会出现列数太多或是行数太多的状况，这时能够经过锁定列来冻结部分列，不随滚动条滑动，方便查看。在Excel中设置冻结列的方法以下：

一样，利用NPOI，经过代码也能实现上面的效果：

HSSFSheet sheet1 = hssfworkbook.CreateSheet("Sheet1");
HSSFRow row1 = sheet1.CreateRow(0);
row1.CreateCell(0).SetCellValue("冻结列");
sheet1.CreateFreezePane(1, 0, 1, 0);

代码执行结果以下：

下面对CreateFreezePane的参数做一下说明：
第一个参数表示要冻结的列数；
第二个参数表示要冻结的行数，这里只冻结列因此为0；
第三个参数表示右边区域可见的首列序号，从1开始计算；
第四个参数表示下边区域可见的首行序号，也是从1开始计算，这里是冻结列，因此为0；

举例说明也许更好理解，将各参数设置为以下：

sheet1.CreateFreezePane(2,0,5,0);

获得的效果以下图：

注意图中C、D和E列默认是看不到的，滚动才看获得，这就是第三个参数5起了做用，是否是很好理解了呢：）

接下来，看一下冻结行的效果。将上面的代码稍做修改：

HSSFSheet sheet1 = hssfworkbook.CreateSheet("Sheet1");
HSSFRow row1 = sheet1.CreateRow(0);
row1.CreateCell(0).SetCellValue("冻结行");
sheet1.CreateFreezePane(0, 1, 0, 1);

执行后生成的Excel文件效果见下图：

那么，若是要行和列同时冻结该怎么作呢？聪明的你必定能想获得，呵呵~~

NPOI 1.2教程 - 显示/隐藏Excel网格线

做者：Tony Qu

NPOI官方网站：http://npoi.codeplex.com/

有些时候，咱们须要网格线，而有些时候咱们不须要，这取决于实际的业务需求。前两天inmegin兄就问我，怎么把网格给去掉，由于他们要把Excel文档当Word使，也许是由于Excel排版方便吧。

Excel中的网格线设置是以表（Sheet）为单位进行管理的，这也就意味着你可让一个表显示网格线，而另外一个表不显示，这是不冲突的。

在Excel 2007中，咱们一般用“工做表选项”面板来设置这个属性:

在面板中，你会发现有2个多选框，一个是查看，一个是打印，也就是说Excel是把查看和打印网格线做为两个设置来处理的，存储的Record也是不一样的。

在NPOI中，若是要让网格线在查看时显示/隐藏，你能够HSSFSheet.DisplayGridlines属性，默认值为true（这也是为何默认状况下咱们可以看到网格线）。下面的代码就是让网格线在查看时不可见的：

HSSFWorkbookhssfworkbook =newHSSFWorkbook();

HSSFSheet s1= hssfworkbook.CreateSheet("Sheet1");

s1.DisplayGridlines=false;

若是要在打印时显示/隐藏网格线，你能够用HSSFSheet.IsGridlinesPrinted属性，默认值为false（这就是默认状况下打印看不到网格线的缘由）。代码和上面差很少：

s1.IsGridsPrinted=true;

上面的代码将在打印时显示网格线，打印的效果以下所示。

在此也提醒你们，若是这个Excel最终客户有打印意向，可别忘了把IsGridPrinted属性也设置上。

相关范例能够参考NPOI 1.2正式版中的DisplayGridlinesInXls项目。

2.6.6用NPOI操做EXCEL－－设置初始视图的行、列

有些时候，咱们可能但愿生成的Excel文件在被打开的时候自动将焦点定位在某个单元格或是选中某个区域中。在NPOI中能够经过SetAsActiveCell和SetActiveCellRange等几个方法实现。

首先咱们看一下设置初始视图中选中某个单元格的方法：

//use HSSFCell.SetAsActiveCell() to select B6 as the active column
HSSFSheet sheet1 = hssfworkbook.CreateSheet("Sheet A");
CreateCellArray(sheet1);
sheet1.GetRow(5).GetCell(1).SetAsActiveCell();
//set TopRow and LeftCol to make B6 the first cell in the visible area
sheet1.TopRow = 5;
sheet1.LeftCol = 1;

其中CreateCellArray(sheet1)方法用来写示范数据，其代码为（下同）：

static void CreateCellArray(HSSFSheet sheet)
{
    for (int i = 0; i < 300; i++)
    {
        HSSFRow row=sheet.CreateRow(i);
        for (int j = 0; j < 150; j++)
        {
            HSSFCell cell = row.CreateCell(j);
            cell.SetCellValue(i*j);
        }
    }
}

生成的Excel打开时效果以下，注意B6为默认选中状态，TopRow和LeftCol设置B6为当前可见区域的第一个单元格：

若是不设置TopRow和LeftCol属性，默认的可见域的第一个单元格为A1，以下是另外一种设置活动单元格的方法，但没有设置此Sheet的TopRow和LeftCol：

HSSFSheet sheet2 = hssfworkbook.CreateSheet("Sheet B");
sheet2.Sheet.SetActiveCell(1, 5);

对应生成的Excel显示为:

除了设置某个单元格为选中状态外，还NPOI能够设置某个区域为选中状态：

//use Sheet.SetActiveCellRange to select a cell range
HSSFSheet sheet3 = hssfworkbook.CreateSheet("Sheet C");
CreateCellArray(sheet3);
sheet3.Sheet.SetActiveCellRange(2, 5, 1, 5);

以上代码设置了Sheet C的选中区域为B3:F6：

还有更强大的，设置多个选中区域：

//use Sheet.SetActiveCellRange to select multiple cell ranges
HSSFSheet sheet4 = hssfworkbook.CreateSheet("Sheet D");
CreateCellArray(sheet4);
List<CellRangeAddress8Bit> cellranges = new List<CellRangeAddress8Bit>();
cellranges.Add(new CellRangeAddress8Bit(1,3,2,5));
cellranges.Add(new CellRangeAddress8Bit(6,7,8,9));
sheet4.Sheet.SetActiveCellRange(cellranges,1,6,9);

若是一个Excel文件中有多个Sheet，还能够经过以下语句设置打开时的初始Sheet：

hssfworkbook.ActiveSheetIndex = 2;

2.6.7用NPOI操做EXCEL－－数据有效性

在有些状况下（好比Excel引入），咱们可能不容许用户在Excel随意输入一些无效数据，这时就要在模板中加一些数据有效性的验证。在Excel中，设置数据有效性的方步骤以下：
（1）先选定一个区域；
数据有效性”中设置数据有效性验证（如图）。à（2）在菜单“数据

一样，利用NPOI，用代码也能够实现：

HSSFSheet sheet1 = hssfworkbook.CreateSheet("Sheet1");

sheet1.CreateRow(0).CreateCell(0).SetCellValue("日期列");
CellRangeAddressList regions1 = new CellRangeAddressList(1, 65535, 0, 0);
DVConstraint constraint1 = DVConstraint.CreateDateConstraint(DVConstraint.OperatorType.BETWEEN, "1900-01-01", "2999-12-31", "yyyy-MM-dd");
HSSFDataValidation dataValidate1 = new HSSFDataValidation(regions1, constraint1);
dataValidate1.CreateErrorBox("error", "You must input a date.");
sheet1.AddValidationData(dataValidate1);

上面是一个在第一列要求输入1900-1-1至2999-12-31之间日期的有效性验证的例子，生成的Excel效果以下，当输入非法时将给出警告：

下面对刚才用到的几个方法加以说明：
CellRangeAddressList类表示一个区域，构造函数中的四个参数分别表示起始行序号，终止行序号，起始列序号，终止列序号。因此第一列所在区域就表示为：

//全部序号都从零算起，第一行标题行除外，因此第一个参数是1，65535是一个Sheet的最大行数
new CellRangeAddressList(1, 65535, 0, 0);

另外，CreateDateConstraint的第一个参数除了设置成DVConstraint.OperatorType.BETWEEN外，还能够设置成以下一些值，你们能够本身一个个去试看看效果：

最后，dataValidate1.CreateErrorBox(title,text)，用来建立出错时的提示信息。第一个参数表示提示框的标题，第二个参数表示提示框的内容。

理解了上面这些，建立一个整数类型的有效性验证也不难实现：

sheet1.CreateRow(0).CreateCell(1).SetCellValue("数值列");
CellRangeAddressList regions2 = new CellRangeAddressList(1, 65535, 1, 1);
DVConstraint constraint2 = DVConstraint.CreateNumericConstraint(DVConstraint.ValidationType.INTEGER,DVConstraint.OperatorType.BETWEEN, "0", "100");
HSSFDataValidation dataValidate2 = new HSSFDataValidation(regions2, constraint2);
dataValidate2.CreateErrorBox("error", "You must input a numeric between 0 and 100.");
sheet1.AddValidationData(dataValidate2);

生成的Excel效果为：

下一节咱们将学习利用数据有效性建立下拉列表的例子。

2.6.8用NPOI操做EXCEL－－生成下拉列表

上一节咱们讲了简单的数据有效性验证，这一节咱们学习一下数据有效性的另外一个应用－－下拉列表。在Excel中，并无相似Web中的下拉控件，其下拉效果是经过数据有效性来实现的。设置步骤为：
（1）选定一个要生成下拉列表的区域；
（2）设置数据有效性为序列，并在来源中填充可选下拉的值，用“,”隔开（如图）。

对应的效果为：

一样，利用NPOI代码也能够实现上面的效果：

HSSFSheet sheet1 = hssfworkbook.CreateSheet("Sheet1");

CellRangeAddressList regions = new CellRangeAddressList(0, 65535, 0, 0);
DVConstraint constraint = DVConstraint.CreateExplicitListConstraint(new string[] { "itemA", "itemB", "itemC" });
HSSFDataValidation dataValidate = new HSSFDataValidation(regions, constraint);
sheet1.AddValidationData(dataValidate);

下面对代码做一下简要说明：
先设置一个须要提供下拉的区域，关于CellRangeAddressList构造函数参数的说明请参见上一节：

CellRangeAddressList regions = new CellRangeAddressList(0, 65535, 0, 0);

而后将下拉项做为一个数组传给CreateExplicitListConstraint做为参数建立一个约束，根据要控制的区域和约束建立数据有效性就能够了。

可是这样会有一个问题：Excel中容许输入的序列来源长度最大为255个字符，也就是说当下拉项的总字符串长度超过255是将会出错。那么若是下拉项不少的状况下应该怎么处理呢？答案是经过引用的方式。步骤以下：
先建立一个Sheet专门用于存储下拉项的值，并将各下拉项的值写入其中：

HSSFSheet sheet2 = hssfworkbook.CreateSheet("ShtDictionary");
sheet2.CreateRow(0).CreateCell(0).SetCellValue("itemA");
sheet2.CreateRow(1).CreateCell(0).SetCellValue("itemB");
sheet2.CreateRow(2).CreateCell(0).SetCellValue("itemC");

而后定义一个名称，指向刚才建立的下拉项的区域：

HSSFName range = hssfworkbook.CreateName();
range.Reference = "ShtDictionary!$A1:$A3";
range.NameName = "dicRange";

最后，设置数据约束时指向这个名称而不是字符数组：

HSSFSheet sheet1 = hssfworkbook.CreateSheet("Sheet1");
CellRangeAddressList regions = new CellRangeAddressList(0, 65535, 0, 0);

DVConstraint constraint = DVConstraint.CreateFormulaListConstraint("dicRange");
HSSFDataValidation dataValidate = new HSSFDataValidation(regions, constraint);
sheet1.AddValidationData(dataValidate);

执行这段代码，生成的Excel效果以下：

在名称管理器中会发现有一个名为"dicRange"的名称，指向"ShtDictionary!$A1:$A3"的下拉项区域：

在数据有效性中会发现来源变成了"=dicRange"，指向上面定义的名称。而不是之前的"itemA,itemB,itemC"：

NPOI 1.2教程 – 3.1 基于.xls模板生成Excel文件

做者：Tony Qu

NPOI官方网站：http://npoi.codeplex.com/

NPOI QQ交流群: 78142590

尽管NPOI可以从头开始生成Excel文件，但在实际生产环境中有不少现成的表格，咱们不可能没事就去从头开始生成一个Excel，更多时候咱们更愿意选择比较偷懒的方法——那就是用模板文件。NPOI一大特点之一就是可以轻松读取Office Excel 97-2003的格式，即便里面有NPOI不支持的VBA宏、图表以及Pivot表之类的高级记录，NPOI也可以保证不丢失数据（说实话，要彻底可以识别全部的Excel内部记录几乎是不可能的，更况且现在又多出了Office Excel 2007binary file，即.xlsb）。

如今咱们转入正题，出于演示目的，我作了一个简单的销售量表，里面应用了文字颜色、背景色、文本居中、公式、千分位分隔符、边框等效果，固然实际的生产环境里可能还有更加复杂的Excel模板。以下图

咱们的程序就是要填充12个月的销售量，Total可以自动根据填充的值计算出总量。

（这里要提一下，以往若是咱们用HTML方式输出xls，咱们必须在服务器端作Total计算，而且这个值在下载后永远都是静态的，没有公式，即便用户要修改里面的数据，总值也不会改变。这也是为何NPOI一直提倡生成真正的Excel文件。）

代码其实很简单：

//read thetemplate via FileStream, it is suggested to use FileAccess.Read to prevent filelock.

//book1.xlsis an Excel-2007-generated file, so some new unknown BIFF records are added.

FileStreamfile =new FileStream(@"template/book1.xls", FileMode.Open,FileAccess.Read);

HSSFWorkbook hssfworkbook = new HSSFWorkbook(file);
HSSFSheet sheet1 = hssfworkbook.GetSheet("Sheet1");
sheet1.GetRow(1).GetCell(1).SetCellValue(200200);
sheet1.GetRow(2).GetCell(1).SetCellValue(300);
sheet1.GetRow(3).GetCell(1).SetCellValue(500050);
sheet1.GetRow(4).GetCell(1).SetCellValue(8000);
sheet1.GetRow(5).GetCell(1).SetCellValue(110);
sheet1.GetRow(6).GetCell(1).SetCellValue(100);
sheet1.GetRow(7).GetCell(1).SetCellValue(200);
sheet1.GetRow(8).GetCell(1).SetCellValue(210);
sheet1.GetRow(9).GetCell(1).SetCellValue(2300);
sheet1.GetRow(10).GetCell(1).SetCellValue(240);
sheet1.GetRow(11).GetCell(1).SetCellValue(180123);
sheet1.GetRow(12).GetCell(1).SetCellValue(150);

//Force excel to recalculate all the formulawhile open

sheet1.ForceFormulaRecalculation=true;

FileStreamfile = new FileStream(@"test.xls", FileMode.Create);
hssfworkbook.Write(file);
file.Close();

首先打开模板文件时要使用FileAccess.Read，这样能够保证文件不被占用。

这里的ForceFormulaRecalculation是强制要求Excel在打开时从新计算的属性，在拥有公式的xls文件中十分有用，你们使用时可别忘了设。

是否是比你想象的简单？你甚至不用去了解它是在什么时候读取文件内容的，对于NPOI的使用者来讲基本上和读取普通文件没有什么两样。

最终生成的效果以下所示：

发觉没，就连千分位分隔符也都保留着，一切就像人工填写的同样。

本范例完整代码请见NPOI.Examples中的GenerateXlsFromXlsTemplate项目。

3.2用NPOI操做EXCEL－－生成九九乘法表

还记得小学时候学的九九乘法表吗？这节咱们一块儿学习利用NPOI经过C#代码生成一张Excel的九九乘法表。要生成九九乘法表，循环确定是少不了的，以下：

HSSFSheet sheet1 = hssfworkbook.CreateSheet("Sheet1");
HSSFRow row;
HSSFCell cell;
for (int rowIndex = 0; rowIndex < 9; rowIndex++)
{
     row = sheet1.CreateRow(rowIndex);
     for (int colIndex = 0; colIndex <= rowIndex; colIndex++)
     {
           cell = row.CreateCell(colIndex);
           cell.SetCellValue(String.Format("{0}*{1}={2}", rowIndex + 1, colIndex + 1, (rowIndex + 1) * (colIndex + 1)));
     }
}

代码其实很简单，就是循环调用cell.SetCellValue(str)写入9行数据，每一行写的单元格数量随行数递增。执行完后生成的Excel样式以下：

完整的代码以下：

Code
using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using NPOI.HSSF.UserModel;
using System.IO;
using NPOI.HPSF;

namespace TimesTables
{
    public class Program
    {
        static HSSFWorkbook hssfworkbook;

        static void Main(string[] args)
        {
            InitializeWorkbook();

            HSSFSheet sheet1 = hssfworkbook.CreateSheet("Sheet1");
            HSSFRow row;
            HSSFCell cell;
            for (int rowIndex = 0; rowIndex < 9; rowIndex++)
            {
                row = sheet1.CreateRow(rowIndex);
                for (int colIndex = 0; colIndex <= rowIndex; colIndex++)
                {
                    cell = row.CreateCell(colIndex);
                    cell.SetCellValue(String.Format("{0}*{1}={2}", rowIndex + 1, colIndex + 1, (rowIndex + 1) * (colIndex + 1)));
                }
            }

            WriteToFile();
        }

        static void WriteToFile()
        {
            //Write the stream data of workbook to the root directory
            FileStream file = new FileStream(@"test.xls", FileMode.Create);
            hssfworkbook.Write(file);
            file.Close();
        }

        static void InitializeWorkbook()
        {
            hssfworkbook = new HSSFWorkbook();

            //create a entry of DocumentSummaryInformation
            DocumentSummaryInformation dsi = PropertySetFactory.CreateDocumentSummaryInformation();
            dsi.Company = "NPOI Team";
            hssfworkbook.DocumentSummaryInformation = dsi;

            //create a entry of SummaryInformation
            SummaryInformation si = PropertySetFactory.CreateSummaryInformation();
            si.Subject = "NPOI SDK Example";
            hssfworkbook.SummaryInformation = si;
        }
    }
}

using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using NPOI.HSSF.UserModel;
using System.IO;
using NPOI.HPSF;

namespace TimesTables
{
    public class Program
    {
        static HSSFWorkbook hssfworkbook;

        static void Main(string[] args)
        {
            InitializeWorkbook();

            HSSFSheet sheet1 = hssfworkbook.CreateSheet("Sheet1");
            HSSFRow row;
            HSSFCell cell;
            for (int rowIndex = 0; rowIndex < 9; rowIndex++)
            {
                row = sheet1.CreateRow(rowIndex);
                for (int colIndex = 0; colIndex <= rowIndex; colIndex++)
                {
                    cell = row.CreateCell(colIndex);
                    cell.SetCellValue(String.Format("{0}*{1}={2}", rowIndex + 1, colIndex + 1, (rowIndex + 1) * (colIndex + 1)));
                }
            }

            WriteToFile();
        }

        static void WriteToFile()
        {
            //Write the stream data of workbook to the root directory
            FileStream file = new FileStream(@"test.xls", FileMode.Create);
            hssfworkbook.Write(file);
            file.Close();
        }

        static void InitializeWorkbook()
        {
            hssfworkbook = new HSSFWorkbook();

            //create a entry of DocumentSummaryInformation
            DocumentSummaryInformation dsi = PropertySetFactory.CreateDocumentSummaryInformation();
            dsi.Company = "NPOI Team";
            hssfworkbook.DocumentSummaryInformation = dsi;

            //create a entry of SummaryInformation
            SummaryInformation si = PropertySetFactory.CreateSummaryInformation();
            si.Subject = "NPOI SDK Example";
            hssfworkbook.SummaryInformation = si;
        }
    }
}

3.3用NPOI操做EXCEL－－生成一张工资单

这一节，咱们将综合NPOI的经常使用功能（包括建立和填充单元格、合并单元格、设置单元格样式和利用公式），作一个工资单的实例。先看建立标题行的代码：

//写标题文本
HSSFSheet sheet1 = hssfworkbook.CreateSheet("Sheet1");
HSSFCell cellTitle = sheet1.CreateRow(0).CreateCell(0);
cellTitle.SetCellValue("XXX公司2009年10月工资单");

//设置标题行样式
HSSFCellStyle style = hssfworkbook.CreateCellStyle();
style.Alignment = HSSFCellStyle.ALIGN_CENTER;
HSSFFont font = hssfworkbook.CreateFont();
font.FontHeight = 20 * 20;
style.SetFont(font);

cellTitle.CellStyle = style;

//合并标题行
sheet1.AddMergedRegion(new Region(0, 0, 1, 6));

其中用到了咱们前面讲的设置单元格样式和合并单元格等内容。接下来咱们循环建立公司每一个员工的工资单：

DataTable dt=GetData();
HSSFRow row;
HSSFCell cell;
HSSFCellStyle celStyle=getCellStyle();

HSSFPatriarch patriarch = sheet1.CreateDrawingPatriarch();
HSSFClientAnchor anchor;
HSSFSimpleShape line;
int rowIndex;
for (int i = 0; i < dt.Rows.Count; i++)
{
    //表头数据
    rowIndex = 3 * (i + 1);
    row = sheet1.CreateRow(rowIndex);

    cell = row.CreateCell(0);
    cell.SetCellValue("姓名");
    cell.CellStyle = celStyle;

    cell = row.CreateCell(1);
    cell.SetCellValue("基本工资");
    cell.CellStyle = celStyle;

    cell = row.CreateCell(2);
    cell.SetCellValue("住房公积金");
    cell.CellStyle = celStyle;

    cell = row.CreateCell(3);
    cell.SetCellValue("绩效奖金");
    cell.CellStyle = celStyle;

    cell = row.CreateCell(4);
    cell.SetCellValue("社保扣款");
    cell.CellStyle = celStyle;

    cell = row.CreateCell(5);
    cell.SetCellValue("代扣个税");
    cell.CellStyle = celStyle;

    cell = row.CreateCell(6);
    cell.SetCellValue("实发工资");
    cell.CellStyle = celStyle;

    DataRow dr = dt.Rows[i];
    //设置值和计算公式
    row = sheet1.CreateRow(rowIndex + 1);
    cell = row.CreateCell(0);
    cell.SetCellValue(dr["FName"].ToString());
    cell.CellStyle = celStyle;

    cell = row.CreateCell(1);
    cell.SetCellValue((double)dr["FBasicSalary"]);
    cell.CellStyle = celStyle;

    cell = row.CreateCell(2);
    cell.SetCellValue((double)dr["FAccumulationFund"]);
    cell.CellStyle = celStyle;

    cell = row.CreateCell(3);
    cell.SetCellValue((double)dr["FBonus"]);
    cell.CellStyle = celStyle;

    cell = row.CreateCell(4);
    cell.SetCellFormula(String.Format("$B{0}*0.08",rowIndex+2));
    cell.CellStyle = celStyle;

    cell = row.CreateCell(5);
    cell.SetCellFormula(String.Format("SUM($B{0}:$D{0})*0.1",rowIndex+2));
    cell.CellStyle = celStyle;

    cell = row.CreateCell(6);
    cell.SetCellFormula(String.Format("SUM($B{0}:$D{0})-SUM($E{0}:$F{0})",rowIndex+2));
    cell.CellStyle = celStyle;

    //绘制分隔线
    sheet1.AddMergedRegion(new Region(rowIndex+2, 0, rowIndex+2, 6));
    anchor = new HSSFClientAnchor(0, 125, 1023, 125, 0, rowIndex + 2, 6, rowIndex + 2);
    line = patriarch.CreateSimpleShape(anchor);
    line.ShapeType = HSSFSimpleShape.OBJECT_TYPE_LINE;
    line.LineStyle = HSSFShape.LINESTYLE_DASHGEL;

}

其中为了文件打印为单元格增长了黑色边框的样式（若是不设置边框样式，打印出来后是没有边框的）。另外，注意循环过程当中excel中的行号随数据源中的行号变化处理。完整代码以下：

using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using NPOI.HSSF.UserModel;
using System.IO;
using NPOI.HPSF;
using NPOI.HSSF.Util;
using System.Data;

namespace Payroll
{
    public class Program
    {
        static HSSFWorkbook hssfworkbook;

        static void Main(string[] args)
        {
            InitializeWorkbook();

            //写标题文本
            HSSFSheet sheet1 = hssfworkbook.CreateSheet("Sheet1");
            HSSFCell cellTitle = sheet1.CreateRow(0).CreateCell(0);
            cellTitle.SetCellValue("XXX公司2009年10月工资单");

            //设置标题行样式
            HSSFCellStyle style = hssfworkbook.CreateCellStyle();
            style.Alignment = HSSFCellStyle.ALIGN_CENTER;
            HSSFFont font = hssfworkbook.CreateFont();
            font.FontHeight = 20 * 20;
            style.SetFont(font);

            cellTitle.CellStyle = style;

            //合并标题行
            sheet1.AddMergedRegion(new Region(0, 0, 1, 6));

            DataTable dt=GetData();
            HSSFRow row;
            HSSFCell cell;
            HSSFCellStyle celStyle=getCellStyle();

            HSSFPatriarch patriarch = sheet1.CreateDrawingPatriarch();
            HSSFClientAnchor anchor;
            HSSFSimpleShape line;
            int rowIndex;
            for (int i = 0; i < dt.Rows.Count; i++)
            {
                //表头数据
                rowIndex = 3 * (i + 1);
                row = sheet1.CreateRow(rowIndex);

                cell = row.CreateCell(0);
                cell.SetCellValue("姓名");
                cell.CellStyle = celStyle;

                cell = row.CreateCell(1);
                cell.SetCellValue("基本工资");
                cell.CellStyle = celStyle;

                cell = row.CreateCell(2);
                cell.SetCellValue("住房公积金");
                cell.CellStyle = celStyle;

                cell = row.CreateCell(3);
                cell.SetCellValue("绩效奖金");
                cell.CellStyle = celStyle;

                cell = row.CreateCell(4);
                cell.SetCellValue("社保扣款");
                cell.CellStyle = celStyle;

                cell = row.CreateCell(5);
                cell.SetCellValue("代扣个税");
                cell.CellStyle = celStyle;

                cell = row.CreateCell(6);
                cell.SetCellValue("实发工资");
                cell.CellStyle = celStyle;

                DataRow dr = dt.Rows[i];
                //设置值和计算公式
                row = sheet1.CreateRow(rowIndex + 1);
                cell = row.CreateCell(0);
                cell.SetCellValue(dr["FName"].ToString());
                cell.CellStyle = celStyle;

                cell = row.CreateCell(1);
                cell.SetCellValue((double)dr["FBasicSalary"]);
                cell.CellStyle = celStyle;

                cell = row.CreateCell(2);
                cell.SetCellValue((double)dr["FAccumulationFund"]);
                cell.CellStyle = celStyle;

                cell = row.CreateCell(3);
                cell.SetCellValue((double)dr["FBonus"]);
                cell.CellStyle = celStyle;

                cell = row.CreateCell(4);
                cell.SetCellFormula(String.Format("$B{0}*0.08",rowIndex+2));
                cell.CellStyle = celStyle;

                cell = row.CreateCell(5);
                cell.SetCellFormula(String.Format("SUM($B{0}:$D{0})*0.1",rowIndex+2));
                cell.CellStyle = celStyle;

                cell = row.CreateCell(6);
                cell.SetCellFormula(String.Format("SUM($B{0}:$D{0})-SUM($E{0}:$F{0})",rowIndex+2));
                cell.CellStyle = celStyle;

                //绘制分隔线
                sheet1.AddMergedRegion(new Region(rowIndex+2, 0, rowIndex+2, 6));
                anchor = new HSSFClientAnchor(0, 125, 1023, 125, 0, rowIndex + 2, 6, rowIndex + 2);
                line = patriarch.CreateSimpleShape(anchor);
                line.ShapeType = HSSFSimpleShape.OBJECT_TYPE_LINE;
                line.LineStyle = HSSFShape.LINESTYLE_DASHGEL;

            }

            WriteToFile();
        }

        static DataTable GetData()
        {
            DataTable dt = new DataTable();
            dt.Columns.Add("FName",typeof(System.String));
            dt.Columns.Add("FBasicSalary",typeof(System.Double));
            dt.Columns.Add("FAccumulationFund", typeof(System.Double));
            dt.Columns.Add("FBonus", typeof(System.Double));

            dt.Rows.Add("令狐冲", 6000, 1000, 2000);
            dt.Rows.Add("任盈盈", 7000, 1000, 2500);
            dt.Rows.Add("林平之", 5000, 1000, 1500);
            dt.Rows.Add("岳灵珊", 4000, 1000, 900);
            dt.Rows.Add("任我行", 4000, 1000, 800);
            dt.Rows.Add("风清扬", 9000, 5000, 3000);

            return dt;
        }


        static HSSFCellStyle getCellStyle()
        {
            HSSFCellStyle cellStyle = hssfworkbook.CreateCellStyle();
            cellStyle.BorderBottom = HSSFCellStyle.BORDER_THIN;
            cellStyle.BorderLeft = HSSFCellStyle.BORDER_THIN;
            cellStyle.BorderRight = HSSFCellStyle.BORDER_THIN;
            cellStyle.BorderTop = HSSFCellStyle.BORDER_THIN;
            return cellStyle;
        }

        static void WriteToFile()
        {
            //Write the stream data of workbook to the root directory
            FileStream file = new FileStream(@"test.xls", FileMode.Create);
            hssfworkbook.Write(file);
            file.Close();
        }

        static void InitializeWorkbook()
        {
            hssfworkbook = new HSSFWorkbook();

            //create a entry of DocumentSummaryInformation
            DocumentSummaryInformation dsi = PropertySetFactory.CreateDocumentSummaryInformation();
            dsi.Company = "NPOI Team";
            hssfworkbook.DocumentSummaryInformation = dsi;

            //create a entry of SummaryInformation
            SummaryInformation si = PropertySetFactory.CreateSummaryInformation();
            si.Subject = "NPOI SDK Example";
            hssfworkbook.SummaryInformation = si;
        }
    }
}

生成的Excel文件样式以下：

3.4用NPOI操做EXCEL－－从Excel中抽取文本

　　咱们知道，搜索引擎最擅长处理的就是文本，而Excel中的内容并非以文本方式存储的。那么若是想要搜索引擎爬虫可以抓取到Excel中的内容是比较困难的，除非搜索引擎爬虫对Excel格式进行专门的处理。那么有没有办法解决此问题呢？有,经过NPOI将Excel内容文本化！

　　以下，有这样一张Excel，若是想让它被搜索引擎收录，经常使用的方式是以HTML形式展示，但将一个个这样的Excel手工作成HTML页面显然比较麻烦。接下来，咱们将提供一种方案，自动将Excel中的内容以HTML形式展示。

　　其实基本思想也很简单，就是经过NPOI读取每一个Cell中的内容，而后以HTML的形式输出。但要保证输出的HTML页面布局与Excel中的一致，还有点小技巧。下面是构造Table的代码：

private HSSFSheet sht;
protected String excelContent;

protected void Page_Load(object sender, EventArgs e)
{
    HSSFWorkbook wb = new HSSFWorkbook(new FileStream(Server.MapPath("App_Data/quotation.xls"), FileMode.Open));
    sht = wb.GetSheet("Sheet1");

    //取行Excel的最大行数
    int rowsCount = sht.PhysicalNumberOfRows;
    //为保证Table布局与Excel同样，这里应该取全部行中的最大列数（须要遍历整个Sheet）。
    //为少一交全Excel遍历，提升性能，咱们能够人为把第0行的列数调整至全部行中的最大列数。
    int colsCount = sht.GetRow(0).PhysicalNumberOfCells;

    int colSpan;
    int rowSpan;
    bool isByRowMerged;

    StringBuilder table = new StringBuilder(rowsCount * 32);

    table.Append("<table border='1px'>");
    for (int rowIndex = 0; rowIndex < rowsCount; rowIndex++)
    {
        table.Append("<tr>");
        for (int colIndex = 0; colIndex < colsCount; colIndex++)
        {
            GetTdMergedInfo(rowIndex, colIndex, out colSpan, out rowSpan, out isByRowMerged);
            //若是已经被行合并包含进去了就不输出TD了。
            //注意被合并的行或列不输出的处理方式不同，见下面一处的注释说明了列合并后不输出TD的处理方式。
            if (isByRowMerged)
            {
                continue;
            }

            table.Append("<td");
            if (colSpan > 1)
                table.Append(string.Format(" colSpan={0}", colSpan));
            if (rowSpan > 1)
                table.Append(string.Format(" rowSpan={0}", rowSpan));
            table.Append(">");

            table.Append(sht.GetRow(rowIndex).GetCell(colIndex));

            //列被合并以后此行将少输出colSpan-1个TD。
            if (colSpan > 1)
                colIndex += colSpan - 1;

            table.Append("</td>");

        }
        table.Append("</tr>");
    }
    table.Append("</table>");

    this.excelContent = table.ToString();
}

　　其中用到的GetTdMergedInfo方法代码以下：

/// <summary>
///  获取Table某个TD合并的列数和行数等信息。与Excel中对应Cell的合并行数和列数一致。
/// </summary>
/// <param name="rowIndex">行号</param>
/// <param name="colIndex">列号</param>
/// <param name="colspan">TD中须要合并的行数</param>
/// <param name="rowspan">TD中须要合并的列数</param>
/// <param name="rowspan">此单元格是否被某个行合并包含在内。若是被包含在内，将不输出TD。</param>
/// <returns></returns>
private void GetTdMergedInfo(int rowIndex, int colIndex, out int colspan, out int rowspan, out bool isByRowMerged)
{
    colspan = 1;
    rowspan = 1;
    isByRowMerged = false;
    int regionsCuont = sht.NumMergedRegions;
    Region region;
    for (int i = 0; i < regionsCuont; i++)
    {
        region = sht.GetMergedRegionAt(i);
        if (region.RowFrom == rowIndex && region.ColumnFrom == colIndex)
        {
            colspan = region.ColumnTo - region.ColumnFrom + 1;
            rowspan = region.RowTo - region.RowFrom + 1;

            return;
        }
        else if (rowIndex > region.RowFrom && rowIndex <= region.RowTo && colIndex>=region.ColumnFrom && colIndex<=region.ColumnTo)
        {
            isByRowMerged = true;
        }
    }
}

最后在apsx页面中输出构建好的Table：

<%=excelContent %>

执行效果以下：

咱们发现，与Excel中的布局彻底同样（这里没有处理单元格的样式，只处理了内容，有兴趣的读者也能够将Excel中单元格的样式也应用在HTML中）。这里为保证布局一致，主要是将Excel中的Region信息解析成Table的colSpan和rowSpan属性，若是对这两个属性不太了解，能够结合如下代码和示例加以了解：

以上HTML代码对应的Table展示为：

3.5用NPOI操做EXCEL－－巧妙使用Excel Chart

　　在NPOI中，自己并不支持Chart等高级对象的建立，但经过l模板的方式能够巧妙地利用Excel强大的透视和图表功能，请看如下例子。

首先创建模板文件，定义两列以及指向此区域的名称“sales”：

建立数据表，数据来源填入刚才定义的区域：

最后生成的数据透视表所在Sheet的样式以下：

至此，模板已经建好，另存为“D:\MyProject\NPOIDemo\Chart\Book2.xls”。咱们发现，模板就至关于一个“空架子”，仅仅有操做方式没并无任何数据。下一步，咱们往这个“空架子”中填入数据。咱们经过以下代码往这个“空架子”中写入数据：

static void Main(string[] args)
{
    HSSFWorkbook wb = new HSSFWorkbook(new FileStream(@"D:\MyProject\NPOIDemo\Chart\Book2.xls", FileMode.Open));

    HSSFSheet sheet1 = wb.GetSheet("Sheet1");

    HSSFRow row = sheet1.CreateRow(1);
    row.CreateCell(0).SetCellValue("令狐冲");
    row.CreateCell(1).SetCellValue(50000);

    row = sheet1.CreateRow(2);
    row.CreateCell(0).SetCellValue("任盈盈");
    row.CreateCell(1).SetCellValue(30000);

    row = sheet1.CreateRow(3);
    row.CreateCell(0).SetCellValue("风清扬");
    row.CreateCell(1).SetCellValue(80000);

    row = sheet1.CreateRow(4);
    row.CreateCell(0).SetCellValue("任我行");
    row.CreateCell(1).SetCellValue(20000);

    //Write the stream data of workbook to the root directory
    FileStream file = new FileStream(@"test.xls", FileMode.Create);
    wb.Write(file);
    file.Close();
}

打开生成的test.xls文件，发现数据已经被填进去了：

再看数据透视表，也有数据了：

总结：
Excel有着强大的报表透视和图表功能，并且简单易用，利用NPOI，能够对其进行充分利用。在作图形报表、透视报表时将很是有用！

NPOI实践: .NET导入Excel文件的另外一种选择

做者：Tony Qu

官方网站：http://npoi.codeplex.com | NPOI QQ交流群: 78142590

NPOI之因此强大，并非由于它支持导出Excel，而是由于它支持导入Excel，并能“理解”OLE2文档结构，这也是其余一些Excel读写库比较弱的方面。一般，读入并理解结构远比导出来得复杂，由于导入你必须假设一切状况都是可能的，而生成你只要保证知足你本身需求就能够了，若是把导入需求和生成需求比作两个集合，那么生成需求一般都是导入需求的子集，这一规律不只体如今Excel读写库中，也体如今pdf读写库中，目前市面上大部分的pdf库仅支持生成，不支持导入。

若是你不相信NPOI可以很好的理解OLE2文档格式，那就去下载POIFS Brower。具体能够参考这篇文章的介绍：Office文件格式解惑。固然单单理解OLE2是不够的，由于Excel文件格式是BIFF，但BIFF是以OLE2为基础的，作个很形象的比喻就是：OLE2至关于磁盘的FAT格式，BIFF至关于文件和文件夹。NPOI负责理解BIFF格式的代码基本都在HSSF命名空间里面。

好了，刚才废话了一下子，主要是给你们打打基础，如今进入正题。

本文将以DataTable为容器读入某xls的第一个工做表的数据（最近群里面不少人问这个问题）。

在开始以前，咱们先来补些基础知识。每个xls都对应一个惟一的HSSFWorkbook，每个HSSFWorkbook会有若干个HSSFSheet，而每个HSSFSheet包含若干HSSFRow（Excel 2003中不得超过65535行），每个HSSFRow又包含若干个HSSFCell（Excel 2003中不得超过256列）。

为了遍历全部的单元格，咱们就得得到某一个HSSFSheet的全部HSSFRow，一般能够用HSSFSheet.GetRowEnumerator()。若是要得到某一特定行，能够直接用HSSFSheet.GetRow(rowIndex)。另外要遍历咱们就必须知道边界，有一些属性咱们是能够用的，好比HSSFSheet.FirstRowNum（工做表中第一个有数据行的行号）、HSSFSheet.LastRowNum（工做表中最后一个有数据行的行号）、HSSFRow.FirstCellNum（一行中第一个有数据列的列号）、HSSFRow.LastCellNum（一行中最后一个有数据列的列号）。

基础知识基本上补得差很少了，如今开工！

首先咱们要准备一个用于打开文件流的函数InitializeWorkbook，因为文件读完后就没用了，因此这里直接用using（养成好习惯，呵呵）。

HSSFWorkbookhssfworkbook;

void InitializeWorkbook(string path)
{
//read the template via FileStream, it is suggested to use FileAccess.Readto prevent file lock.

//book1.xlsis an Excel-2007-generated file, so some new unknown BIFF records are added.

    using (FileStream file =new FileStream(path, FileMode.Open,FileAccess.Read))
    {
        hssfworkbook = newHSSFWorkbook(file);
    }
}

接下来咱们要开始写最重要的函数ConvertToDataTable，即把HSSF的数据放到一个DataTable中。

HSSFSheetsheet = hssfworkbook.GetSheetAt(0);
System.Collections.IEnumerator rows = sheet.GetRowEnumerator();

while(rows.MoveNext())
{
HSSFRow row = (HSSFRow)rows.Current;
//TODO::Create DataTable row

    for (int i = 0; i < row.LastCellNum; i++)
    {
        HSSFCell cell = row.GetCell(i);
        //TODO::set cell value to the cell of DataTables

}

上面的结构你们都应该能看懂吧，无非就是先遍历行，再遍历行中的每一列。这里引出了一个难点，因为Excel的单元格有好几种类型，类型不一样显示的东西就不一样，具体的类型有布尔型、数值型、文本型、公式型、空白、错误。

publicenum HSSFCellType
{
    Unknown = -1,
    NUMERIC = 0,
    STRING = 1,
    FORMULA = 2,
    BLANK = 3,
    BOOLEAN = 4,
    ERROR = 5,
}

这里的HSSFCellType描述了全部的类型，但细心的朋友可能已经发现了，这里没有日期型，这是为何呢？这是由于Excel底层并无必定日期型，而是经过数值型来替代，至于如何区分日期和数字，都是由文本显示的样式决定的，在NPOI中则是由HSSFDataFormat来处理。为了可以方便的得到所须要的类型所对应的文本，咱们可使用HSSFCell.ToString()来处理。

因而刚才的代码则变成了这样：

HSSFSheetsheet = hssfworkbook.GetSheetAt(0);
System.Collections.IEnumerator rows = sheet.GetRowEnumerator();

DataTable dt = new DataTable();
for (int j = 0; j < 5;j++)
{
    dt.Columns.Add(Convert.ToChar(((int)'A')+j).ToString());
}

while(rows.MoveNext())
{
    HSSFRow row = (HSSFRow)rows.Current;
    DataRow dr = dt.NewRow();

    for (int i = 0; i < row.LastCellNum; i++)
    {
        HSSFCell cell = row.GetCell(i);

        if (cell == null)
        {
            dr[i] = null;
        }
        else

{

dr[i] = cell.ToString();

}

dt.Rows.Add(dr);

}

是否是很简单，呵呵！

固然，若是你要对某个特定的单元格类型作特殊处理，能够经过判HSSFCell.CellType来解决，好比下面的代码：

        switch(cell.CellType)
        {
            case HSSFCellType.BLANK:
                dr[i] = "[null]";
                break;
            case HSSFCellType.BOOLEAN:
                dr[i] =cell.BooleanCellValue;
                break;
            case HSSFCellType.NUMERIC:
                dr[i] =cell.ToString();    //This is a trick to get the correct value of the cell.NumericCellValue will return a numeric value no matter the cell value is a dateor a number.

               break;
            case HSSFCellType.STRING:
                dr[i] =cell.StringCellValue;
                break;
            case HSSFCellType.ERROR:
                dr[i] = cell.ErrorCellValue;
                break;
            case HSSFCellType.FORMULA:
            default:
                dr[i] = "="+cell.CellFormula;
                break;
        }

这里只是举个简单的例子。

完整代码下载：http://files.cnblogs.com/tonyqus/ImportXlsToDataTable.zip

注意，此代码中不包括NPOI的assembly，不然文件会很大，因此建议去npoi.codeplex.com下载。