C# NPOI操作Excel

一、NPOI簡介

NPOI是一個在C#/.NET平台上使用的讀寫Excel2007及Excel 97-2003文件的開源組件。支持流和文件兩種方式讀取和寫入。NPOI是一款基於.NET框架的組件，可以更方便地處理Excel文件。同時，NPOI還支持Word和PowerPoint文件的處理。

NPOI具有NPOI.HSSF、NPOI.XSSF、NPOI.HPSF和NPOI.POIFSFilesystem四個包。其中，NPOI.HSSF適用於操作Excel2003及Excel 97-2003文件，而NPOI.XSSF適用於操作Excel2007文件。NPOI.HPSF可以讀取和寫入Office Document Properties，而NPOI.POIFSFilesystem可用於操作OLE2 Compound Document文件格式。

NPOI是NHibernate的一部分，可以與NHibernate無縫集成。

二、NPOI的特點

NPOI是使用C#語言開發的，可以運行在Windows、Linux和Mac系統上。NPOI支持各種類型的數據源，包括特定存儲庫、XML文檔和ADO數據源。NPOI的介面友好，易於使用。同時，NPOI還具有以下特點：

1、高效快速：NPOI使用基於流的方法，讀寫速度快，佔用內存少。

2、靈活可擴展：NPOI的API清晰簡單，易於擴展。可以通過繼承和重載方式新增自定義功能。

3、功能豐富：NPOI能夠實現Excel的大部分功能，包括單元格樣式、合併單元格、保護工作表和單元格、數據校驗等。

三、NPOI的安裝

在C#項目中使用NPOI需要引入NPOI的dll文件。NPOI官方網站提供了兩種獲取方式：

1、從NPOI的官網上下載源代碼後自行編譯得到dll文件。

//引入命名空間
using NPOI.XSSF.UserModel;
using NPOI.SS.UserModel;
using System.IO;
//創建Excel文件
XSSFWorkbook wb = new XSSFWorkbook();
ISheet sheet = wb.CreateSheet("Sheet1");
IRow row = sheet.CreateRow(0);
row.CreateCell(0).SetCellValue("This is a test");
row.CreateCell(1).SetCellValue(4.5);
row.CreateCell(2).SetCellValue(true);
//將Excel文件保存到磁碟文件中
FileStream sw = File.Create("D:\\workbook.xlsx");
wb.Write(sw);
sw.Close();

2、使用NuGet包管理器來獲取NPOI。

//安裝NPOI
Install-Package NPOI -Version 2.4.1
//引入命名空間
using NPOI.XSSF.UserModel;
using NPOI.SS.UserModel;
using System.IO;
//創建Excel文件
XSSFWorkbook wb = new XSSFWorkbook();
ISheet sheet = wb.CreateSheet("Sheet1");
IRow row = sheet.CreateRow(0);
row.CreateCell(0).SetCellValue("This is a test");
row.CreateCell(1).SetCellValue(4.5);
row.CreateCell(2).SetCellValue(true);
//將Excel文件保存到磁碟文件中
FileStream sw = File.Create("D:\\workbook.xlsx");
wb.Write(sw);
sw.Close();

四、NPOI操作Excel

以下是一段基本的使用NPOI操作Excel的代碼示例：

//引入命名空間
using NPOI.XSSF.UserModel;
using NPOI.SS.UserModel;
using System.IO;
//讀取Excel文件
FileStream fs = new FileStream("D:\\workbook.xlsx", FileMode.Open, FileAccess.Read);
XSSFWorkbook wb = new XSSFWorkbook(fs);
ISheet sheet = wb.GetSheet("Sheet1");//獲取Sheet1工作表
IRow row = sheet.GetRow(0);//獲取第一行
string cellValue = row.GetCell(0).ToString();//獲取第一行第一列單元格的值
//向Excel文件中寫入數據
row.CreateCell(1).SetCellValue("Hello world");//在第一行第二列寫入數據
FileStream sw = File.Open("D:\\workbook.xlsx", FileMode.Open, FileAccess.Write);
wb.Write(sw);//將Excel文件保存到磁碟文件中
sw.Close();

通過以上代碼，我們可以實現Excel文件的讀取和寫入，並且可以操作Excel文件中的單元格、行和列。

五、NPOI操作Excel中的常用功能

1、設置單元格樣式

NPOI支持多種樣式的單元格，包括字體、顏色、邊框、對齊方式等。以下是設置單元格樣式的代碼示例：

//引入命名空間
using NPOI.XSSF.UserModel;
using NPOI.SS.UserModel;
using System.IO;
//創建Excel文件
XSSFWorkbook wb = new XSSFWorkbook();
ISheet sheet = wb.CreateSheet("Sheet1");
IRow row = sheet.CreateRow(0);
ICellStyle style = wb.CreateCellStyle();//新建單元格樣式
style.Alignment = HorizontalAlignment.Center;//設置水平居中
style.VerticalAlignment = VerticalAlignment.Center;//設置垂直居中
sheet.SetColumnWidth(0, 20 * 256);//設置第一列列寬
IRow row = sheet.CreateRow(0);
ICell cell = row.CreateCell(0);
cell.SetCellValue("This is a test");
cell.CellStyle = style;//設置單元格樣式
//將Excel文件保存到磁碟文件中
FileStream sw = File.Create("D:\\workbook.xlsx");
wb.Write(sw);
sw.Close();

2、合併單元格

NPOI可以將單元格進行合併，合併後的單元格將佔用合併區域內的所有單元格。以下是合併單元格的代碼示例：

//引入命名空間
using NPOI.XSSF.UserModel;
using NPOI.SS.UserModel;
using System.IO;
//創建Excel文件
XSSFWorkbook wb = new XSSFWorkbook();
ISheet sheet = wb.CreateSheet("Sheet1");
IRow row = sheet.CreateRow(0);
ICellStyle style = wb.CreateCellStyle();//新建單元格樣式
style.Alignment = HorizontalAlignment.Center;//設置水平居中
style.VerticalAlignment = VerticalAlignment.Center;//設置垂直居中
sheet.SetColumnWidth(0, 20 * 256);//設置第一列列寬
IRow row = sheet.CreateRow(0);
ICell cell = row.CreateCell(0);
cell.SetCellValue("合併單元格");
cell.CellStyle = style;//設置單元格樣式
//合併單元格
sheet.AddMergedRegion(new CellRangeAddress(0, 4, 0, 4));//合併第一行到第五行，第一列到第五列的單元格
//將Excel文件保存到磁碟文件中
FileStream sw = File.Create("D:\\workbook.xlsx");
wb.Write(sw);
sw.Close();

3、保護工作表和單元格

NPOI可以保護工作表和單元格，以防止用戶意外地修改數據。以下是保護工作表和單元格的代碼示例：

//引入命名空間
using NPOI.XSSF.UserModel;
using NPOI.SS.UserModel;
using System.IO;
//創建Excel文件
XSSFWorkbook wb = new XSSFWorkbook();
ISheet sheet = wb.CreateSheet("Sheet1");
sheet.ProtectSheet("password");//保護工作表，設置密碼為password
IRow row = sheet.CreateRow(0);
row.CreateCell(0).SetCellValue("This is a test");
//保護單元格
ICellStyle style = wb.CreateCellStyle();
style.IsLocked = true;
sheet.DefaultColumnStyle = style;//設置默認單元格樣式
sheet.DefaultRowHeight = 500;//設置默認行高
sheet.LockFormatColumns = true;//鎖定所有列
sheet.LockFormatRows = true;//鎖定所有行
//將Excel文件保存到磁碟文件中
FileStream sw = File.Create("D:\\workbook.xlsx");
wb.Write(sw);
sw.Close();

4、數據校驗

NPOI可以對單元格進行數據校驗，以保證數據的正確性和完整性。以下是設置數據校驗的代碼示例：

//引入命名空間
using NPOI.XSSF.UserModel;
using NPOI.SS.UserModel;
using System.IO;
//創建Excel文件
XSSFWorkbook wb = new XSSFWorkbook();
ISheet sheet = wb.CreateSheet("Sheet1");
IRow row = sheet.CreateRow(0);
row.CreateCell(0).SetCellValue("Age：");
sheet.SetColumnWidth(0, 20 * 256);//設置第一列列寬
//數據校驗
IDataValidationHelper validationHelper = sheet.GetDataValidationHelper();
IDataValidationConstraint constraint = validationHelper.CreateNumericConstraint(ComparisonOperator.GreaterThan, "0");//設置數據校驗規則，數字必須大於0
CellRangeAddressList regions = new CellRangeAddressList(0, 0, 1, 1);//設置校驗單元格範圍
IDataValidation dataValidation = validationHelper.CreateValidation(constraint, regions);//創建數據校驗對象
sheet.AddValidationData(dataValidation);//將校驗對象應用到工作表
//將Excel文件保存到磁碟文件中
FileStream sw = File.Create("D:\\workbook.xlsx");
wb.Write(sw);
sw.Close();

六、總結

使用NPOI可以快速、方便地實現對Excel文件的讀寫操作。同時，NPOI還支持各種高級功能，如單元格樣式、合併單元格、保護工作表和單元格、數據校驗等。需要注意的是，在使用NPOI時需要引入相應的dll文件，並且API清晰簡單、易於擴展，可以滿足各種定製化需求。