NPOI Library (C# Excel 操作)

NPOI 函式庫

NPOI 函式庫可以在 http://npoi.codeplex.com 中下載，目前的版本為 1.2.1，有分為 .NET 1.1 與 .NET 2.0 以上版本兩種，支援主要的 POI 專案提供的功能，但專案中的範例程式碼都是以 Excel 為標的，原因應該是 Excel 在伺服器端的處理遠比 Word 和 PowerPoint 等文件要多太多了，故筆者在本篇文章也是以 Excel 檔案為主要說明的標的。

NPOI 函式庫檔案有七個，分別是：

• NPOI.DLL：NPOI 核心函式庫。
• NPOI.DDF.DLL：NPOI 繪圖區讀寫函式庫。
• NPOI.HPSF.DLL：NPOI 文件摘要資訊讀寫函式庫。
• NPOI.HSSF.DLL：NPOI Excel BIFF 檔案讀寫函式庫。
• NPOI.Util.DLL：NPOI 工具函式庫。
• NPOI.POIFS.DLL：NPOI OLE 格式存取函式庫。
• ICSharpCode.SharpZipLib.DLL：檔案壓縮函式庫。

一般需要存取 Excel 97-2003 格式（.xls）的檔案時，需要使用 NPOI、NPOI.HSSF、NPOI.POIFS 與 NPOI.Util 函式庫，因此專案中要引用這四個 DLL，若要一併存取文件摘要資訊時，則也要引用 NPOI.HPSF.DLL 檔案，以取得必要的類別宣告。開發人員通常只要集中精神在 NPOI.HSSF.UserModel 命名空間即可，它包含了控制 Excel 資料的各式類別物件供開發人員取用。

在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;
 
 
  //create a entry of DocumentSummaryInformation
            DocumentSummaryInformation dsi = PropertySetFactory.CreateDocumentSummaryInformation();
            dsi.Company = "NPOI Team";
            hssfworkbook.DocumentSummaryInformation = dsi;


            //create a entry of SummaryInformation
            SummaryInformation si = PropertySetFactory.CreateSummaryInformation();
            si.Subject = "NPOI SDK Example";
            hssfworkbook.SummaryInformation = si;

using System;
using System.Collections.Generic;
using System.Linq;
using System.Web;
using System.Web.UI;
using System.Web.UI.WebControls;
using System.IO;

using NPOI;
using NPOI.HPSF;
using NPOI.HSSF;
using NPOI.HSSF.UserModel;
using NPOI.POIFS;
using NPOI.Util;


public partial class excel : System.Web.UI.Page
{
    protected void Page_Load(object sender, EventArgs e)
    {


    }

    protected void Button1_Click(object sender, EventArgs e)
    {
        HSSFWorkbook workbook = new HSSFWorkbook();
        MemoryStream ms = new MemoryStream();


        // 新增試算表。
        HSSFSheet sheet = workbook.CreateSheet("My Sheet") as HSSFSheet;
        // 插入資料值。


        HSSFCellStyle style1 = workbook.CreateCellStyle() as HSSFCellStyle;
        style1.FillForegroundColor = NPOI.HSSF.Util.HSSFColor.BLUE.index2;
        style1.FillPattern = NPOI.SS.UserModel.FillPatternType.SOLID_FOREGROUND;
        HSSFCellStyle style2 = workbook.CreateCellStyle() as HSSFCellStyle;
        style2.FillForegroundColor = NPOI.HSSF.Util.HSSFColor.YELLOW.index2;
        style2.FillPattern = NPOI.SS.UserModel.FillPatternType.BIG_SPOTS;


        for (int i = 0; i < 10; i++)
        {
            HSSFRow row = sheet.CreateRow(i) as HSSFRow;
            for (int j = 0; j < 5; j++)
            {
                HSSFCell cell = row.CreateCell(j) as HSSFCell;
                cell.SetCellValue(i.ToString() + "+" + j.ToString() + DateTime.Now.Ticks.ToString());
                if (j % 2 == 0)
                    cell.CellStyle = style1;
            }
        }






        workbook.Write(ms);
        Response.AddHeader("Content-Disposition", string.Format("attachment; filename=EmptyWorkbook.xls"));
        Response.BinaryWrite(ms.ToArray());


        workbook = null;
        ms.Close();
        ms.Dispose();
    }
}