NPOI 是開源的 POI 項目的.NET版，可以用來讀寫Excel，Word，PPT文件。

僅需處理 XLS/XLSX 格式的文本和數字讀寫，最少需要加載?2 個核心 DLL：

1. NPOI.dll
   包含所有格式的通用接口（IWorkbook、ISheet、IRow、ICell?等），是 NPOI 的基礎核心庫。

2. 對應格式的專用 DLL

   • 處理 XLS（97-2003）：需?NPOI.HSSF.dll
   • 處理 XLSX（2007+）：需?NPOI.XSSF.dll

如果同時需要支持兩種格式，則需要加載?3 個 DLL：NPOI.dll?+?NPOI.HSSF.dll?+?NPOI.XSSF.dll。說明：

• 不需要額外引用?NPOI.HPSF.dll（處理 OLE2 文檔屬性，基礎讀寫用不到）。
• 不需要?NPOI.DDF.dll、NPOI.POIFS.dll?等（這些用于復雜功能如圖片、公式、加密等）。
• 若使用 NuGet 安裝?NPOI?包，會自動包含所有依賴，但實際運行時僅上述核心 DLL 是必須的。

對于簡單的文本和數字讀寫，這幾個 DLL 足以滿足需求。

在處理Excel文件上，NPOI 可以同時兼容 xls 和 xlsx。

官網提供了一份 Examples，? ? ?給出了很多應用場景的例子，打包好的二進制文件類庫，也僅有幾MB，使用非常方便。? ? ?讀Excel

{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 comes hereif (DateUtil.IsCellDateFormatted(cell)){value = cell.DateCellValue;}else{// Numeric typevalue = cell.NumericCellValue;}break;case CellType.Boolean:// Boolean typevalue = cell.BooleanCellValue;break;case CellType.Formula:value = cell.CellFormula;break;default:// String typevalue = cell.StringCellValue;break;}}}catch (Exception){value = "";}return value;
}

AI寫代碼csharp運行

特別注意的是CellType中沒有Date，而日期類型的數據類型是Numeric，其實日期的數據在Excel中也是以數字的形式存儲。可以使用DateUtil.IsCellDateFormatted方法來判斷是否是日期類型。

有了GetCellValue方法，寫數據到Excel中的時候就要有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());}
}

cell.SetCellValue()方法只有四種重載方法，參數分別是string, bool, DateTime, double, IRichTextString
設置公式使用cell.SetCellFormula(string formula)寫Excel

以下是簡單的例子，更多信息可以參見官網提供的Examples。

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();//樣式
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;//文字垂直對齊方式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 = j % 2 == 0 ? style1 : style2;//根據數據類型設置不同類型的cellobject obj = data[i, j];SetCellValue(cell, data[i, j]);//如果是日期，則設置日期顯示的格式if (obj.GetType() == typeof(DateTime)){cell.CellStyle = dateStyle;}//如果要根據內容自動調整列寬，需要先setCellValue再調用//sheet.AutoSizeColumn(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);//向打開的這個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