C#教程之NPOI读写excel文件XLS,XLSX格式
NPOI 是开源的 POI 项目的.NET版，可以用来读写Excel，Word，PPT文件。
仅需处理 XLS/XLSX 格式的文本和数字读写，最少需要加载 2 个核心 DLL：
NPOI.dll
包含所有格式的通用接口（IWorkbook、ISheet、IRow、ICell等），是 NPOI 的基础核心库。对应格式的专用 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