自封装的pdfium动态库

1

1 1

1 认识

认识认识

认识 NPOI

NPOI NPOI

NPOI

本章将介绍 NPOI 的一些基本信息，包括以下几个部分

•

什么是 NPOI

•

版权说明

•

相关资源

•

团队介绍

•

未来展望

•

各 Assembly 的作用

的版本是 1.2.1，在该版本中仅支持读写 Excel 文件和 Drawing 格式，其他文件格式将在以

后的版本中得到支持。

1.2

1.2 1.2

1.2 版权说明

版权说明版权说明

版权说明

NPOI 采用的是 Apache 2.0 许可证（poi 也是采用这个许可证），这意味着它可以被用

于任何商业或非商业项目，你不用担心因为使用它而必须开放你自己的源代码，所以它对于

很多从事业务系统开发的公司来说绝对是很不错的选择。

当然作为一个开源许可证，肯定也是有一些义务的，例如如果你在系统中使用 NPOI，

你必须保留 NPOI 中的所有声明信息。对于源代码的任何修改，必须做出明确的标识。

完整的 apache 2.0 许可证请见 http://www.phpx.com/man/Apache-2/license.html

QQ 交流群: 78142590

1.4 1.4

团队介绍团队介绍

Tony Qu 来自于中国上海，是这个项目的发起人和开发人员，时区是 GMT+8，2008 年 9

月开始了 NPOI 的开发，负责 NPOI 所有底层库的开发、测试和 bug 修复。个人 blog 地址为

http://tonyqus.cnblogs.com/

Hüseyin Tüfekçilerli 来自于土耳其的伊斯坦布尔，也是这个项目的开发人员，时区

是 GMT+2，2008 年 11 月参与了 NPOI 的开发，主要负责 POIFS Browser 1.0 的开发工作。个

人 blog 地址为 http://huseyint.com/

aTao.Xiang，来自中国，2009 年 8 月开始参与该项目，主要参与了 NPOI 1.2 中文版的

撰写工作和推广工作。个人 blog 地址为 http://www.cnblogs.com/atao/

1.5

1.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

1.6

Assembly 的作用

NPOI.DDF： Microsoft Drawing 格式读写库

NPOI.HPSF： OLE2 的 Summary Information 和 Document Summary Information 属性

读写库

NPOI.HSSF ： Excel BIFF 格式读写库

2.1

2.1 2.1

2.1 创建基本内容

创建基本内容创建基本内容

创建基本内容

2.1.1

2.1.1 2.1.1

2.1.1 创建

创建创建

创建 Workbook

WorkbookWorkbook

Workbook 和

和和

和 Sheet

Sheet Sheet

Sheet

创建 Workbook 说白了就是创建一个 Excel 文件，当然在 NPOI 中更准确的表示是在内存

中创建一个 Workbook 对象流。

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

NPOI.dll

NPOI.POIFS.dll

NPOI.HSSF.dll

NPOI.Util.dll

要创建一个新的 xls 文件其实很简单，只要我们初始化一个新的 HSSFWorkbook 实例就

行了，如下所示：

using

usingusing

using NPOI.HSSF.UserModel;

NPOI.HSSF.UserModel; NPOI.HSSF.UserModel;

NPOI.HSSF.UserModel;

...

......

...

HSSFSheet sheet = hssfworkbook.CreateSheet(

HSSFSheet sheet = hssfworkbook.CreateSheet(HSSFSheet sheet = hssfworkbook.CreateSheet(

HSSFSheet sheet = hssfworkbook.CreateSheet("new sheet"

"new sheet""new sheet"

"new sheet");

如果要创建标准的 Excel 文件，即拥有 3 个 Sheet，可以用下面的代码：

hssfworkbook.CreateSheet(hssfworkbook.CreateSheet(

hssfworkbook.CreateSheet(

hssfworkbook.CreateSheet(hssfworkbook.CreateSheet(

hssfworkbook.CreateSheet("Sheet2"

h

hh

hssfworkbook.CreateSheet(

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

FileStream file =

FileStream file = FileStream file =

FileStream file = new

newnew

new FileStream(

FileStream( FileStream(

FileStream(@"test.xls"

, FileMode.Create);, FileMode.Create);

, FileMode.Create);

最后你可以打开 test.xls 文件确认一下，是不是有 3 个空的 Sheet。

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

2.1.2

2.1.2 2.1.2

2.1.2 创建

创建创建

创建 DocumentSummaryInformation

DocumentSummaryInformationDocumentSummaryInformation

DocumentSummaryInformation 和

和和

和 SummaryInformation

SummaryInformationSummaryInformation

SummaryInformation

前一节中我们讲解了如何创建一个新的 Workbook，但在此过程中大家也许会发现一个

细节，这些文件没有包括 DocummentSummaryInformation 和 SummaryInformation 头。如果

你还不是很清楚我在说什么，可以看 POIFS Browser 打开 test.xls 文件后的截图：

你会发现只有 Workbook 目录，其他什么都没有，但事实上一个正常的 xls 文件，比如

说 Excel 生成的 xls 文件是类似下面的结构：

修改界面，只是没有 Vista 这么方便，如下所示：