NPOI 是開源的 POI 項目的.NET版，可以用來讀寫Excel，Word，PPT文件。在處理Excel文件上，NPOI 可以同時兼容 xls 和 xlsx。官網提供了一份 Examples，給出了很多應用場景的例子，打包好的二進制文件類庫，也僅有幾MB，使用非常方便。
讀Excel
NPOI使用HSSFWorkbook類來處理xls，XSSFWorkbook類來處理xlsx，它們都繼承接口IWorkbook，因此可以通過IWorkbook來統一處理xls和xlsx格式的文件。
以下是簡單的例子
public void ReadFromExcelFile(string filePath)
{
IWorkbook wk = null;
string extension = System.IO.Path.GetExtension(filePath);
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);
}
}
Excel中的單元格是有不同數據格式的，例如數字，日期，字符串等，在讀取的時候可以根據格式的不同設置對象的不同類型，方便後期的數據處理。
//獲取cell的數據，並設置為對應的數據類型
public object GetCellValue(ICell cell)
{
object value = null;
try
{
if (cell.CellType != CellType.Blank)
{
switch (cell.CellType)
{
case CellType.Numeric:
// Date Type的數據CellType是Numeric
if (DateUtil.IsCellDateFormatted(cell))
{
value = cell.DateCellValue;
}
else
{
// Numeric type
value = cell.NumericCellValue;
}
break;
case CellType.Boolean:
// Boolean type
value = cell.BooleanCellValue;
break;
default:
// String type
value = cell.StringCellValue;
break;
}
}
}
catch (Exception)
{
value = "";
}
return value;
}
特別注意的是CellType中沒有Date，而日期類型的數據類型是Numeric，其實日期的數據在Excel中也是以數字的形式存儲。可以使用DateUtil.IsCellDateFormatted方法來判斷是否是日期類型。
有了GetCellValue方法，寫數據到Excel中的時候就要有SetCellValue方法，缺的類型可以自己補。
//根據數據類型設置不同類型的cell
public 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());
}
}
cell.SetCellValue()方法只有四種重載方法，參數分別是string, bool, DateTime, double, IRichTextString（公式用IRichTextString）
寫Excel
以下是簡單的例子，更多信息可以參見官網提供的Examples。
public void WriteToExcel(string filePath)
{
//創建工作薄
IWorkbook wb;
string extension = System.IO.Path.GetExtension(filePath);
//根據指定的文件格式創建對應的類
//URL：http://www.bianceng.cn/Programming/csharp/201410/45750.htm
if (extension.Equals(".xls"))
{
wb = new HSSFWorkbook();
}
else
{
wb = new XSSFWorkbook();
}
ICellStyle style1 = wb.CreateCellStyle();//樣式
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;//自動換行
ICellStyle style2 = wb.CreateCellStyle();//樣式
IFont font1 = wb.CreateFont();//字體
font1.FontName = "楷體";
font1.Color = HSSFColor.Red.Index;//字體顏色
font1.Boldweight = (short)FontBoldWeight.Normal;//字體加粗樣式
style2.SetFont(font1);//樣式裡的字體設置具體的字體樣式
//設置背景色
style2.FillForegroundColor = NPOI.HSSF.Util.HSSFColor.Yellow.Index;
style2.FillPattern = FillPattern.SolidForeground;
style2.FillBackgroundColor = NPOI.HSSF.Util.HSSFColor.Yellow.Index;
style2.Alignment = NPOI.SS.UserModel.HorizontalAlignment.Left;//文字水平對齊方式
style2.VerticalAlignment = NPOI.SS.UserModel.VerticalAlignment.Center;//文字垂直對齊方式
//創建一個表單
ISheet sheet = wb.CreateSheet("Sheet0");
//設置列寬
int[] columnWidth = { 10, 10, 10, 20 };
//測試數據
int rowCount = 3, columnCount = 4;
object[,] data = {
{"列0", "列1", "列2", "列3"},
{"", 400, 5.2, 6.01},
{"", DateTime.Today, true, "2014-07-02"}
};
for (int i = 0; i < columnWidth.Length; i++)
{
//設置列寬度，256*字符數，因為單位是1/256個字符
sheet.SetColumnWidth(i, 256 * columnWidth[i]);
}
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);
cell.CellStyle = j % 2 == 0 ? style1 : style2;
//根據數據類型設置不同類型的cell
SetCellValue(cell, data[i, j]);
}
}
//合並單元格，如果要合並的單元格中都有數據，只會保留左上角的
//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); //向打開的這個xls文件中寫入表並保存。
fs.Close();
}
catch (Exception e)
{
Debug.WriteLine(e.Message);
}
}
如果想要設置單元格為只讀或可寫，可以參考這裡，實際上只需要如下兩個步驟：
cell.CellStyle.IsLocked = false;//設置該單元格為非鎖定
sheet.ProtectSheet("password");//保護表單，password為解鎖密碼
cell.CellStyle.IsLocked 默認就是true，因此第2步一定要執行，才能實現鎖定單元格，對於不想鎖定的單元格，就一定要設置cell.CellStyle.IsLocked = false
