作者:Tony Qu
========================================
[更新] NPOI 1.2.4 新教程地址:http://tonyqus.sinaapp.com
========================================
NPOI 微博: http://weibo.com/npoi
NPOI QQ交流群:
群1:189925337
群2:124527967
群3: 116053476
更新
2009.3.24 把npoi 1.2 alpha的链接换成NPOI 1.2 beta
2009.11.18 把npoi 1.2 beta的链接换成NPOI 1.2.1; 增加NPOI教程链接
2009.12.1 增加QQ群
===================================================
本文将通过问答的方式帮助你了解NPOI。
什么是NPOI?
NPOI,顾名思义,就是POI的.NET版本。那POI又是什么呢?POI是一套用Java写成的库,能够帮助开发者在没有安装微软Office的情况下读写Office 97-2003的文件,支持的文件格式包括xls, doc, ppt等。目前POI的稳定版本中仅支持Excel文件格式xls,其他的都属于不稳定版本(放在poi的scrachpad目录中)。NPOI是构建在POI 3.x版本之上的,本月发布的NPOI 1.2是对应于POI 3.2 final的,所以它支持Excel文件读写,但由于人手和精力原因,还没有实现读写Word, PowerPoint, Visio的文件格式。
NPOI的官方网站是啥?
为什么用NPOI?
因为它能够帮助你生成真正的Office文件格式,比如说Excel文件格式。我曾经看到好几个园友发过有关如何生成Excel报表的帖子,大家确实花了很多心思,具体的帖子如下:
生成Excel高级报表(用的是Office PIA库)
http://www.cnblogs.com/xiaobier/archive/2008/10/13/1310399.html
Datagrid数据导出到excel文件的三种方法
http://www.cnblogs.com/xieduo/articles/606202.html
其中提到了的2种方法分别是:cvs法、html法
.net 操作 EXCEL
http://www.cnblogs.com/jhobo/archive/2009/02/17/1392423.html
其中提到了Office PIA法、OLEDB法、OPENXML法
特别是其中的cvs法和html法值得提一下,这得感谢Microsoft Office对于格式的强大兼容性,貌似国产某某Office软件就无法正常显示基于html的xls文件。
好了,回到我们的问题上,为什么要用NPOI呢?
第一点,你不需要在服务器上安装微软的Office,可以避免版权问题。
第二点,使用起来比Office PIA的API更加方便,更人性化。
第三点,你不用去花大力气维护NPOI,NPOI Team会不断更新、改善NPOI,绝对省成本。
第四点,很多事情是html和cvs法做不到的,比如说公式计算[Cell C1]=A1+B1*A2、单元格高级样式(如文本旋转、对齐、宽度)等,其中公式计算可以适当减轻服务器端的计算压力
第五点,你很难保证你的客户机器上都安装了Office 2007或Office Compatiblity Pack for Office 2003,出于向前兼容的考虑,还是生成Office 97-2003格式比较可靠
当然有人要说了,那我用myXls等同类产品可不可以?当然可以,纯属个人喜好,这就好比你愿意用NHibernate还是NBear,完全可以自由选择。
NPOI由哪些东西组成?
NPOI目前主要由以下部分组成
NPOI.POIFS | OLE2 Document File System Library |
NPOI.DDF | Microsoft Office Drawing format Library |
NPOI.HPSF | OLE2 Propertyset library (包括SummaryInformation和DocumentSummaryInformation) |
NPOI.HSSF | Microsoft Excel BIFF library |
NPOI.SS | Formula Evaluation library |
NPOI.Util | 基础类库,提供了很多实用功能,可用于其他读写文件格式项目的开发 |
NPOI目前的版本如何?包括哪些功能?
目前NPOI的最新版是NPOI 1.2.1,其中包括了以下功能:
a. 读写OLE2文档
b. 读写DocummentSummaryInformation和SummaryInformation
c. 基于LittleEndian的字节读写
d. 读写Excel BIFF格式
e. 识别并读写Excel BIFF中的常见Record,如RowRecord, StyleRecord, ExtendedFormatRecord
f. 支持设置单元格的高、宽、样式等
g. 支持调用部分Excel内建函数,比如说sum, countif以及计算符号
h. 支持在生成的Xls内嵌入打印设置,比如说横向/纵向打印、缩放、使用的纸张等
i. …… (功能太多,无法一一例举,大家自己研究吧)
下载地址:http://npoi.codeplex.com/Release/ProjectReleases.aspx?ReleaseId=19351
在开发中哪些地方可以使用NPOI
a. 生成Excel报表
b. Excel中的文本提取(主要用于搜索引擎)
c. 批量生成Excel文件
d. 基于Excel文件模板生成新的Excel
e. 研究Excel BIFF文件格式及OLE2文件格式
NPOI的最终目标是什么?
a. 能够读写几乎所有的Office 97-2003文件格式,至少能够支持Word, PowerPoint, Excel, Visio的格式,其他的会根据实际需求而定。
b. 作为教学Office文件格式的“活”教材,也可作为研究生阶段研究数据结构的教材。
即使是目前的1.2版本也很不完善,支持的Excel功能还很有限,没有搞过NPOI的研发,包括我在内的很多人很难想象微软这样一个Excel软件的开发量,其中除了我们常用的基本功能以外,还有很多内置函数的实现、对行进行分组、行的锁定、表单的保护等。说实话有些功能我也是第一次听说,是在开发中一边看Excel界面一边实现的(呵呵,是不是很土)。由于Office 2007为了兼容Office 97-2003,在其基础上增加了很多新的Record,所以要生成真正意义上的全新的Excel BIFF很难(话说微软的开发速度贼快)。
在NPOI以后的版本中还会支持Pivot表和图表(Chart),其实你在poi的svn中已经可以看到最新的pivot和chart的代码了,只是还在开发中,没有发布正式版本,估计今年中旬会发一个新的版本。
我也想研究Office文件格式,有没有相关的文档和工具可供参考?
首先是文件格式的说明文档,你可以去微软的官方网站下载:http://www.microsoft.com/interop/docs/officebinaryformats.mspx
接着是,我和Huseyin共同开发了POIFS Browser,目前的版本是1.2,已经能够识别Excel BIFF了。
你可以去http://npoi.codeplex.com/Release/ProjectReleases.aspx?ReleaseId=23409下载。
我可以参加NPOI开发组吗?
当然可以,我非常欢迎大家加入NPOI Team,因为目前狂缺人手,很多事情要做,比如说实现读写Word格式的库,即HWPF;还需要有人帮忙一起写文档、写范例、写教程。目前团队中只有2个人,我和Huseyin(土耳其人),最近Huseyin也很忙,没时间维护NPOI,所以我很需要你的加入。大家有兴趣可以到http://npoi.codeplex.com/Thread/View.aspx?ThreadId=36157回帖,或者直接发邮件给我(具体邮件地址见我blog的左边栏)。
NPOI有教程吗?
有,该教程是为NPOI 1.2写的,详细目录请见http://www.cnblogs.com/tonyqus/archive/2009/04/12/1434209.html
NPOI Team下一步准备干嘛?
上一个问题中提到事情真的很多,下面罗列一下:
a. 使Excel读写库(HSSF)更加稳定
b. 开发HSSF对Pivot Table和Chart的支持
c. 开发Word读写库(HWPF)、PowerPoint读写库(HSLF)
d. 把HSSF的注释补全,把java的注释转成.NET的,便于用NDoc生成文档和智能感知
e. 写NPOI 1.2的范例(目前只有10个左右,目标是>50个,类似于微软的SDK,这样方便大家学习和理解)
f. 写NPOI 1.2的教程
作者:Tony Qu & aTao.Xiang
========================================
[更新] NPOI 1.2.4 新教程地址:http://tonyqus.sinaapp.com/
========================================
NPOI官方网站:http://npoi.codeplex.com/
QQ交流群: 124527967, 116053476, 189925337
声明:本教程未经许可不得用于任何商业目的
目录更新日期:2010年1月5日
很多人可能对NPOI还很陌生,别担心,通过本教程你将对NPOI有进一步的认识和理解。
在此,特别感谢aTao.xiang 2个多月的无私奉献,正是因为他,我们才能看到这份教材的完整版,感动ing~。
目录
2. 使用NPOI生成xls文件
2.1 创建基本内容
2.1.2 创建DocumentSummaryInformation和SummaryInformation
2.2 单元格操作
2.3 使用Excel公式
2.4 创建图形
2.6 高级功能
3. 项目实践