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();

        IRow row = sheet.GetRow();  //读取当前行数据
        //LastRowNum 是当前表的总行数-1（注意）
        int offset = ;
        for (int i = ; i <= sheet.LastRowNum; i++)
        {
            row = sheet.GetRow(i);  //读取当前行数据
            if (row != null)
            {
                //LastCellNum 是当前行的总列数
                for (int j = ; 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 = { , , ,  };
    for (int i = ; i < columnWidth.Length; i++)
    {
        //设置列宽度，256*字符数，因为单位是1/256个字符
        sheet.SetColumnWidth(i,  * columnWidth[i]);
    }

    //测试数据
    int rowCount = , columnCount = ;
    object[,] data = {
        {"列0", "列1", "列2", "列3"},
        {"", , 5.2, 6.01},
        {"", true, "2014-07-02", DateTime.Now}
        //日期可以直接传字符串，NPOI会自动识别
        //如果是DateTime类型，则要设置CellStyle.DataFormat，否则会显示为数字
    };

    IRow row;
    ICell cell;

    for (int i = ; i < rowCount; i++)
    {
        row = sheet.CreateRow(i);//创建第i行
        for (int j = ; 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(, , , );
    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。

参考

　　http://baike.baidu.com/link?url=In96nUM_dx8u2WJzpMxuWRU6FDK-Y7h5bhFjDUBR82glVZ8MSCDYbi-Ha4AYXooObrp0_KaawAykxmwmrdEI2q

　　http://www.cnblogs.com/restran/p/3889479.html