NPOI - .NET Excel & Word操作组件
概要
NPOI 是 POI 项目的 .NET 版本。POI是一个开源的Java读写Excel、WORD等微软OLE2组件文档的项目。
NPOI是构建在POI 3.x版本之上的，它可以在没有安装Office的情况下对Word/Excel文档进行读写操作。
NPOI的优势
1）免费开源
2）包含了大部分EXCEL的特性(单元格样式、数据格式、公式等等)
3）支持多种文件格式（xls/xlsx/doc/docx）
4）采用面向接口的设计架构( 可以查看 NPOI.SS 的命名空间)
5）支持文件的导入与导出
6）服务器无需安装微软的Office，可以避免版权问题
7）持续更新，NPOI Team会不断更新、改善NPOI
构成
NPOI 1.2.x主要由POIFS、DDF、HPSF、HSSF、SS、Util六部分组成。
|
NPOI.POIFS
|
OLE2/ActiveX文档属性读写库
|
|
NPOI.DDF
|
Microsoft Office Drawing读写库
|
|
NPOI.HPSF
|
OLE2/ActiveX文档读写库
|
|
NPOI.HSSF
|
Microsoft Excel BIFF(Excel 97-2003)格式读写库
|
|
NPOI.SS
|
Excel公用接口及Excel公式计算引擎
|
|
NPOI.Util
|
基础类库，提供了很多实用功能，可用于其他读写文件格式项目的开发
|
NPOI读取Excel
NPOI 使用 HSSFWorkbook 类来处理 xls，XSSFWorkbook 类来处理 xlsx，它们都继承接口 IWorkbook，因此可以通过 IWorkbook 来统一处理 xls 和 xlsx 格式的文件。
示例：读取Excel文件内容，支持xls(Excel97-2003)、xlsx 格式。
public void ReadExcel(string filePath) { IWorkbook wk = null; string extension = System.IO.Path.GetExtension(filePath).ToLower(); try { FileStream fs = File.OpenRead(filePath); if (extension.Equals(".xls")) { //把xls文件中的数据写入wk中 wk = new HSSFWorkbook(fs); } else { //把xlsx文件中的数据写入wk中 wk = new XSSFWorkbook(fs); } fs.Close(); //读取当前表数据 ISheet sheet = wk.GetSheetAt(0); IRow row = sheet.GetRow(0); //读取当前行数据 //LastRowNum 是当前表的总行数-1（注意） int offset = 0; for (int i = 0; i <= sheet.LastRowNum; i++) { row = sheet.GetRow(i); //读取当前行数据 if (row != null) { //LastCellNum 是当前行的总列数 for (int j = 0; j < row.LastCellNum; j++) { //读取该行的第j列数据 string value = row.GetCell(j).ToString(); Console.Write(value.ToString() + " "); } Console.WriteLine("\n"); } } } catch (Exception e) { //只在Debug模式下才输出 Console.WriteLine(e.Message); } }
示例：读取单元格数据（根据单元格数类型，返回对应的数据类型）
public object GetCellValue(ICell cell) { object value = null; try { if (cell.CellType != CellType.Blank) { switch (cell.CellType) { case CellType.Numeric: // Date comes here if (DateUtil.IsCellDateFormatted(cell)) { value = cell.DateCellValue; } else { // Numeric type value = cell.NumericCellValue; } break; case CellType.Boolean: // Boolean type value = cell.BooleanCellValue; break; case CellType.Formula: value = cell.CellFormula; break; default: // String type value = cell.StringCellValue; break; } } } catch (Exception) { value = ""; } return value; }
特别注意的是CellType中没有Date，而日期类型的数据类型是Numeric，其实日期的数据在Excel中也是以数字的形式存储。
可以使用DateUtil.IsCellDateFormatted方法来判断是否是日期类型。
有了GetCellValue方法，写数据到Excel中的时候就要有SetCellValue方法，下面介绍通过NPOI写入Excel。
NOPI写入Excel
public void WriteToExcel(string filePath) { //创建工作薄 IWorkbook wb; string extension = System.IO.Path.GetExtension(filePath); //根据指定的文件格式创建对应的类 if (extension.Equals(".xls")) { wb = new HSSFWorkbook(); } else { wb = new XSSFWorkbook(); } ICellStyle style1 = wb.CreateCellStyle(); //单元格样式1 style1.Alignment = NPOI.SS.UserModel.HorizontalAlignment.Left; //文字水平对齐方式 style1.VerticalAlignment = NPOI.SS.UserModel.VerticalAlignment.Center; //文字垂直对齐方式 //设置边框 style1.BorderBottom = NPOI.SS.UserModel.BorderStyle.Thin; style1.BorderLeft = NPOI.SS.UserModel.BorderStyle.Thin; style1.BorderRight = NPOI.SS.UserModel.BorderStyle.Thin; style1.BorderTop = NPOI.SS.UserModel.BorderStyle.Thin; style1.WrapText = true;//自动换行
//字体
IFont font1 = wb.CreateFont();//字体
font1.FontName = "楷体";
font1.Color = HSSFColor.Red.Index;//字体颜色
font1.Boldweight = (short)FontBoldWeight.Normal;//字体加粗样式
style1.SetFont(font1);//样式里的字体设置具体的字体样式
//设置背景色 style1.FillForegroundColor = NPOI.HSSF.Util.HSSFColor.Yellow.Index; style1.FillPattern = FillPattern.SolidForeground; style1.FillBackgroundColor = NPOI.HSSF.Util.HSSFColor.Yellow.Index; style1.Alignment = NPOI.SS.UserModel.HorizontalAlignment.Left;//文字水平对齐方式 style1.VerticalAlignment = NPOI.SS.UserModel.VerticalAlignment.Center;//文字垂直对齐方式 ICellStyle dateStyle = wb.CreateCellStyle(); //定义日期的显示样式
dateStyle.Alignment = NPOI.SS.UserModel.HorizontalAlignment.Left;//文字水平对齐方式
dateStyle.VerticalAlignment = NPOI.SS.UserModel.VerticalAlignment.Center;//文字垂直对齐方式
//设置数据显示格式
IDataFormat dataFormatCustom = wb.CreateDataFormat();
dateStyle.DataFormat = dataFormatCustom.GetFormat("yyyy-MM-dd HH:mm:ss");
//创建一个表单
ISheet sheet = wb.CreateSheet("Sheet0");
//设置列宽
int[] columnWidth = { 10, 10, 20, 10 };
for (int i = 0; i < columnWidth.Length; i++)
{
//设置列宽度，256*字符数，因为单位是1/256个字符
sheet.SetColumnWidth(i, 256 * columnWidth[i]);
}
//测试数据
int rowCount = 3, columnCount = 4;
object[,] data = {
{"列0", "列1", "列2", "列3"},
{"", 400, 5.2, 6.01},
{"", true, "2014-07-02", DateTime.Now}
//日期可以直接传字符串，NPOI会自动识别
//如果是DateTime类型，则要设置CellStyle.DataFormat，否则会显示为数字
};
IRow row;
ICell cell;
for (int i = 0; i < rowCount; i++)
{
row = sheet.CreateRow(i);//创建第i行
for (int j = 0; j < columnCount; j++)
{
cell = row.CreateCell(j);//创建第j列
cell.CellStyle = style1 ;
//根据数据类型设置不同类型的cell
object obj = data[i, j];
SetCellValue(cell, data[i, j]); //SetCellValue() 的实现参见下方代码
//如果是日期，则设置日期显示的格式
if (obj.GetType() == typeof(DateTime))
{
cell.CellStyle = dateStyle;
}
//如果要根据内容自动调整列宽，需要先setCellValue再调用
//sheet.AutoSizeColumn(j);
}
}
try {
FileStream fs = File.OpenWrite(filePath);
wb.Write(fs);//向打开的这个Excel文件中写入表单并保存。
fs.Close();
}
catch (Exception e)
{
Debug.WriteLine(e.Message);
}
}
上面代码调用的SetCellValue（）方法实现：
//根据数据类型设置不同类型的cell public static void SetCellValue(ICell cell, object obj) { if (obj.GetType() == typeof(int)) { cell.SetCellValue((int)obj); } else if (obj.GetType() == typeof(double)) { cell.SetCellValue((double)obj); } else if (obj.GetType() == typeof(IRichTextString)) { cell.SetCellValue((IRichTextString)obj); } else if (obj.GetType() == typeof(string)) { cell.SetCellValue(obj.ToString()); } else if (obj.GetType() == typeof(DateTime)) { cell.SetCellValue((DateTime)obj); } else if (obj.GetType() == typeof(bool)) { cell.SetCellValue((bool)obj); } else { cell.SetCellValue(obj.ToString()); } }
代码示例：合并单元格
//合并单元格，如果要合并的单元格中都有数据，只会保留左上角的 //CellRangeAddress(0, 2, 0, 0)，合并0-2行，0-0列的单元格 CellRangeAddress region = new CellRangeAddress(0, 2, 0, 0); sheet.AddMergedRegion(region); try { FileStream fs = File.OpenWrite(filePath); wb.Write(fs);//向打开的这个Excel文件中写入表单并保存。 fs.Close(); } catch (Exception e) { Debug.WriteLine(e.Message); }
代码示例：单元格读写属性
ICellStyle unlocked = wb.CreateCellStyle(); unlocked.IsLocked = false;//设置该单元格为非锁定 cell.SetCellValue("未被锁定"); cell.CellStyle = unlocked; ... //保护表单，password为解锁密码 //cell.CellStyle.IsLocked = true;的单元格将为只读 sheet.ProtectSheet("password");
cell.CellStyle.IsLocked 默认就是true，因此sheet.ProtectSheet("password")一定要执行，才能实现锁定单元格，对于不想锁定的单元格，就一定要设置cell的CellStyle中的IsLocked = false。
参考
