适用于.net的操作excel的库

知识点概要

知识点具体说明(使用步骤、解释)

使用场景及示例

1. EPPlus

2. NPOI

3. ClosedXml

4. SpreadsheetLight

5.ExcelDataReader 开源库

6. ExcelDataWriter

总结

知识点概要

使用Excel来导入和导出数据，在日常工作中使用频率是相当高的，而直接去读取Excel数据还是比较繁琐的，使用 EPPlus 、 ClosedXML 等第三方库读取 Excel 数据相较于直接读取，则方便的多，第三方库通常都提供了简单、实用、易于理解的高层次API，具有很高的可用性，使得开发效率大大提高，同时也使得代码更易于理解和维护。现在我们就总结一下适合于.Net操作Excel的库。

知识点具体说明(使用步骤、解释)

Excel其实是由XML发展而来的，它实际上是一个ZIP压缩包，其中包含了很多的文件和文件夹，我们可以将一个excel文件的后缀改成“.zip”，然后打开就可以看到其内部组成文件了。

所以使用库来操作excel还是很有必要的。

现在我整理了一下几个常见的比较稳定的库：

1. EPPlus(1亿2306万下载量，123M)

2. ClosedXML(8399万下载量，84M)

3. NPOI(5872万下载量， 58.8M)

4. SpreadsheetLight(284万下载量，2.8M)，跨平台可能会有GDI+（图形设备接口）的初始化问题、兼容性问题；

5. ExcelDataReader(6092万下载量，61M) ，ExcelDataWriter(0.89万下载量，9.0K)

6. Microsoft.Office.Interop.Excel(2148万下载量，21.5M), 需要依赖Microsoft office，跨平台就不用考虑了；

7. Syncfusion Excel (XlsIO)、GemBox.Spreadsheet都是功能强大的商业库；

下面就分别说一下。

使用场景及示例

下面就用代码来实际说一下，实验环境为使用Avalonia读取到了文件流：

await using var stream = await file.OpenReadAsync(); //已经读取到stream流

下面就用各个库来分析获取想要的数据。

1. EPPlus

EPPlus是一个非常流行的开源 .NET 库，用于读取和写入 Excel 文件（只适用.xlsx 格式）；

开源，跨平台；

性能优秀，适合处理大型 Excel 文件；

支持 LINQ 查询，可以方便地对 Excel 数据进行操作和过滤；

支持许多 Excel 公式和函数，可以在文档中直接使用；

单元格的行、列Index是从1开始；

private async Task<List<TemplateData>> ReadFilesByEpplus(Stream stream)
{try{ExcelPackage.LicenseContext = LicenseContext.NonCommercial;using var package = new ExcelPackage(stream); // 用流加载Excel包  var worksheet = package.Workbook.Worksheets[0]; // 获取第一个工作表  var datas = new List<TemplateData>();var rowCount = worksheet.Dimension.End.Row;  var colCount = worksheet.Dimension.End.Column;  // 遍历每一行  for (var row = 2; row <= rowCount; row++) // 从第二行开始  {var t = new ExcelRow(){ColumnData = new List<string>()};// 遍历每一列  for (var col = 1; col <= colCount; col++)  {  var cellValue = worksheet.Cells[row, col].Text; // 获取当前单元格的文本  t.ColumnData.Add(cellValue); // 将值添加到ColumnData  }// 将读取的数据添加到列表  datas.Add(t.ToTemplateData());  } return datas;}catch (Exception e){var logger = LogManager.GetCurrentClassLogger();logger.Error($"ReadFiles Exception: {e.Message}");return null;}
}

值得一提的是，EPPlus 从版本 5 开始引入了许可证管理，所以在使用的代码中设置ExcelPackage.LicenseContext 属性：

ExcelPackage.LicenseContext = LicenseContext.NonCommercial; // 对于非商业用途

当然，也可以在配置文件中设置。

如果不进行设置的话，会触发异常：

Exception: Please set the ExcelPackage.LicenseContext property. See https://epplussoftware.com/developers/licenseexception

EPPlus 官网也给出了解决方案：

1. 代码中直接设置：

2. 配置文件

3. 环境变量

2. NPOI

NPOI 也是一个比较好用的非常流行的开源 .NET 库，而且不仅可以处理Excel，也支持 Word 文档（.doc 和 .docx）、PowerPoint（.ppt 和 .pptx）等其他Office 文件格式。

支持读取 .xls 和 .xlsx 文件，但导入方式不同。需要根据文件格式使用 HSSFWorkbook 或 XSSFWorkbook；支持公式、样式、图表和图像的管理；操作工作表（如插入、删除或修改行和列）；

NPOI单元格行、列Index都是从0开始；

private async Task<List<TemplateData>> ReadFiles(Stream stream)
{try{var workbook = new XSSFWorkbook(stream);  var worksheet = workbook.GetSheetAt(0);var datas = new List<TemplateData>();for (var row = 1; row <= worksheet.LastRowNum; row++) // row=1 跳过表头  {  var temp = new ExcelRow { ColumnData = new List<string>() };var currentRow = worksheet.GetRow(row); // 获取当前行  if (currentRow == null) continue; // 确保行不为空  for (var col = 0; col < currentRow.LastCellNum; col++) // 遍历每一列  {  var cell = currentRow.GetCell(col); // 获取当前列的单元格,得到的是单元格的内容  // 尝试获取单元格的值  var cellValue = cell?.ToString(); // 转换为字符串  temp.ColumnData.Add(cellValue); // 添加到 ColumnData 列表中  }  // 将读取的数据添加到列表  datas.Add(temp.ToTemplateData());} return datas;}catch (Exception e){var logger = LogManager.GetCurrentClassLogger();logger.Error($"ReadFiles Exception: {e.Message}");return null;}
}

3. ClosedXml

能够快速创建、读取、写入和修改 Excel 文件，而不需要深入了解 Excel 的复杂结构，ClosedXML 库的目标是使 Excel 操作简单而强大；

支持单元格写入、格式化、图表生成、数据验证、合并单元格等，能够满足大多数 Excel 操作的需求；

支持 LINQ 查询；

仅支持 .xlsx 格式，不可以操作 .xls 文件；

单元格行、列index从1开始；

private async Task<List<TemplateData>> ReadFilesByClosedXml(Stream stream)
{try{using var workbook = new XLWorkbook(stream);var worksheet = workbook.Worksheet(1);var datas = new List<TemplateData>();var rowNum = worksheet.LastRowUsed().RowNumber();for (var row = 2; row <= rowNum; row++) // row=1 跳过表头  {  var temp = new ExcelRow { ColumnData = new List<string>() };var colNum = worksheet.LastColumnUsed().ColumnNumber();for (var col = 1; col <= colNum; col++) // 遍历每一列  {  // 获取当前列的单元格var cell = worksheet.Cell(row,col).GetString(); // 尝试获取单元格的值  temp.ColumnData.Add(cell); // 添加到 ColumnData 列表中  }  // 将读取的数据添加到列表  datas.Add(temp.ToTemplateData());} return datas;}catch (Exception e){var logger = LogManager.GetCurrentClassLogger();logger.Error($"ReadFiles Exception: {e.Message}");return null;}
}

4. SpreadsheetLight

轻量级的.NET库，创建、读取、写入、图表支持、数据验证等；适合快速开发和原型制作。

开源，可在Mono框架下运行，实现跨平台，不过得不偿失，仍可能会有些兼容性问题,

比如：

“Exception: The type initializer for 'Gdip' threw an exception” ；

5.ExcelDataReader 开源库

是一个用于读取 Excel 文件的轻量级库，特别适用于 .xls 和 .xlsx 文件格式。专为快速和高效的数据读取而设计，特别适合需要将 Excel 数据导入到数据库或进行其他处理的场景。只支持数据的读取，而不支持 Excel 文件的写入和格式化；

行、列index从0开始；

private async Task<List<TemplateData>> ReadFiles(IStorageFile file)
{try{Encoding.RegisterProvider(CodePagesEncodingProvider.Instance);  var datas = new List<TemplateData>();await using var stream = await file.OpenReadAsync();using var reader = ExcelReaderFactory.CreateReader(stream);// 读取所有数据  var result = reader.AsDataSet();  // 遍历获取的 DataSetforeach (DataTable table in result.Tables)  {  Console.WriteLine($"Sheet: {table.TableName}");  for (var row = 1; row < table.Rows.Count; row++) //跳过第一行{var temp = new ExcelRow { ColumnData = [] };for (var col = 0; col < table.Rows[row].ItemArray.Length; col++){var cell = table.Rows[row][col];temp.ColumnData.Add(cell?.ToString());}datas.Add(temp.ToTemplateData());}}return datas;}catch (Exception e){var logger = LogManager.GetCurrentClassLogger();logger.Error($"ReadFiles Exception: {e.Message}");return null;}
}