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并不是随便设置的，而是由一些固定的值决定的，具体的值与对应的纸张如下表所示：

（此表摘自《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 项目。

活动地点：浦东南路3500号（近华丰路）汉庭快捷酒店世博村店一楼会议室

提供的服务：茶水、无线上网（免费）

费用：35元/人（到场签到时付费）

人数：50人

活动日程安排
13:30-14:00          签到，领取小礼品和意见反馈表
14:00-15:15          集中化WCF服务管理和部署（Teddy Ma）
15:15-15:45          Q&A
15:45-16:00          茶歇
16:00-17:00          博客园近期话题线下互动
17:00-17:30          抽奖、自由交流、合影

报名方法：

请发邮件到 ，写上你的真实姓名和网名，方便到场时签到。由于场地方面的限制，人数将控制在50人左右，前50封报名邮件我们将发邀请邮件予以确认，望那些没有报名成功的兄弟能够谅解，也希望在以后的活动中能够看到您的身影。

注：回复不作为报名凭证

联系方式：

联系人：瞿杰（Tony Qu）

Email：

MSN:

交通指南：

直达公交: 576区间路 955路 周陈线 86路 785路 大桥一线 978 610

路线一（2, 4, 6号线沿线）：坐地铁2号线、4号线或6号线到世纪大道站，从1号口出来在东方路张杨路站台坐978或610至华丰路站下，车站旁就是汉庭酒店

路线二（8号线沿线）：坐地铁8号线到耀华路站下车，到浦东南路上的车站换乘978或82，到华丰路站下车，马路对面就是汉庭世博店

路线三（曲阳、外滩）：乘坐576，到华丰路站下来就是

赞助：

本次活动由沪江网和图灵教育共同赞助（排名不分先后）

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

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

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

在Excel 2007中，我们通常用“工作表选项”面板来设置这个属性:

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

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

HSSFWorkbook hssfworkbook = new HSSFWorkbook();
HSSFSheet s1 = hssfworkbook.CreateSheet("Sheet1");
s1.DisplayGridlines = false;

如果要在打印时显示/隐藏网格线，你可以用HSSFSheet.IsGridlinesPrinted属性，默认值为false（这就是默认情况下打印看不到网格线的原因）。代码和上面差不多：

s1.IsGridsPrinted = true;

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

在此也提醒大家，如果这个Excel最终客户有打印意向，可别忘了把IsGridPrinted属性也设置上。

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

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开始算起的。

HSSFWorkbook hssfworkbook = new HSSFWorkbook();
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项目。

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

很多人可能对NPOI还很陌生，别担心，通过本教程你将对NPOI有进一步的认识和理解。

目录

1. 认识NPOI

1.1 什么是NPOI

1.2 版权说明

1.3 相关资源

1.4 团队介绍

1.5 未来展望

1.6 各Assembly的作用

2. 使用NPOI生成xls文件

2.1 创建基本内容

2.1.1 创建Workbook和Sheet

2.1.2 创建DocumentSummaryInformation和SummaryInformation

2.1.3 创建单元格

2.1.5 创建批注

2.1.6 创建页眉和页脚

2.2 单元格操作

2.2.1 设置格式

2.2.2 合并单元格

2.2.3 对齐相关设置

2.2.4 使用边框

2.2.5 字体设置

2.2.6 背景和纹理

2.2.7 设置宽度和高度

2.3 使用Excel公式

2.3.1 基本计算

2.3.2 SUM函数

2.3.3 日期函数

2.3.4 字符串相关函数

2.3.5 IF函数

2.3.6

2.3.7 CountIf函数

2.3.8 随机数函数

2.4 创建图形

2.4.1 画线

2.4.2 画多边形

2.4.3 画圆形

2.4.4 画Grid

2.4.5 插入图片

2.5 打印设置

2.5.1 设置打印方向

2.5.2 设置页数

2.5.3 设置纸张类型

2.5.4 设置缩放比例

2.5.5 设置Margin

2.5.6

2.6 高级功能

2.6.1 调整表单显示比例

2.6.2 设置密码

2.6.3 组合行、列

2.6.4 锁定列

2.6.5 显示/隐藏网格线

2.6.6 设置初始视图的行、列

3. 项目实践

3.1 使用模板

3.2 生成九九乘法表

3.3 生成一张工资单

3.4 从xls文件中抽取文本

3.5 批量生成xls文件

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

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

现在假设你要设置B列的宽度，就可以用下面的代码：

HSSFWorkbook hssfworkbook = new HSSFWorkbook();
HSSFSheet sheet1 = 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项目

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

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

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

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

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

所以以上单元格如果要用NPOI来设置就可以用以下代码完成：

//fill background
HSSFCellStyle style8 = 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官方网站：http://npoi.codeplex.com/

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

在设置字体之前，我们首先要做的就是创建字体对象，这和创建数字格式很相似。

HSSFFont font = hssfworkbook.CreateFont();

这句话会在Excel文件内部创建相应的FontRecord，所以你不用客户因为自己机器上的Excel没有相应的字体设置而导致设置丢失。

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

HSSFCellStyle style1 = 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.Underline属性，这是一个byte类型的值，例如

font.Underline=HSSFFont.U_SINGLE

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

上标下标

设置这东西可以用HSSFFont.TypeOffset属性，值有以下几种：

所以如果你要上标的话，可以用下面的代码：

font.TypeOffset=HSSFFont.SS_SUPER;

删除线

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

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

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

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

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

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

边框范例图	对应的静态值
	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，都是静态实例，可以直接引用。

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

HSSFSheet sheet = hssfworkbook.CreateSheet("new sheet");

// Create a row and put some cells in it. Rows are 0 based.
HSSFRow row = sheet.CreateRow(1);
// Create a cell and put a value in it.
HSSFCell cell = row.CreateCell(1);
// Style the cell with borders all around.
HSSFCellStyle style = 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官方网站：http://npoi.codeplex.com/

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

首先我们用代码创建必要的单元格，代码如下：

HSSFWorkbook hssfworkbook = new HSSFWorkbook();
HSSFSheet sheet1 = hssfworkbook.CreateSheet("Sheet1");
HSSFRow row = sheet1.CreateRow(0);
row.CreateCell(0).SetCellValue("Test");

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

请注意接下来我们要做的所有操作都是在CellStyle的基础上完成的，所以我们创建一个HSSFCellStyle：

HSSFCellStyle style=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。