在ASP.NET中如何获取Excel文件的所有工作表名称？

背景与需求

在ASP.NET项目中，处理Excel文件是常见场景，例如自动化报表生成、数据迁移等，当Excel文件包含多个工作表时，程序需获取所有工作表名称以进行后续操作（如选择特定工作表、批量处理），本文将详细介绍在ASP.NET环境下，通过编程方式获取Excel文件所有工作表名称的方法，并分析不同解决方案的优劣。

技术选型：库的选择

传统方法依赖Microsoft Office Interop，需用户本地安装Office，存在兼容性问题，推荐使用开源库：

• NPOI：支持.NET Core/Standard，无Office依赖，性能稳定，适合大型项目。
• EPPlus：轻量级，适合.NET Framework，但需注意版本兼容性。
• ClosedXML：纯C#实现，但处理复杂格式时性能略逊于NPOI。

本文以NPOI为例，提供完整解决方案。

实现步骤详解

1. 添加NPOI库

   通过NuGet包管理器安装：

2. 引入核心命名空间

   在C#代码中添加：

   

   using NPOI.HSSF.UserModel; // 处理.xls文件 using NPOI.XSSF.UserModel; // 处理.xlsx文件

3. 打开Excel文件并获取工作表集合

   使用Workbook类加载文件，通过Workbook.Worksheets属性访问所有工作表。

4. 遍历工作表并提取名称

   遍历WorksheetCollection，获取每个工作表的名称。

5. 异常处理

   处理文件不存在、权限不足等异常，确保程序健壮性。

   

代码示例

以下为完整代码片段（C#，ASP.NET Web API示例）：

using System; using System.Collections.Generic; using System.IO; using NPOI.HSSF.UserModel; using NPOI.XSSF.UserModel; public class ExcelHelper { /// <summary> /// 获取Excel文件所有工作表名称 /// </summary> /// <param name="filePath">Excel文件路径</param> /// <returns>工作表名称列表</returns> public static List<string> GetSheetNames(string filePath) { List<string> sheetNames = new List<string>(); try { // 根据文件扩展名选择工作簿类 IWorkbook workbook = null; if (Path.GetExtension(filePath).Equals(".xlsx", StringComparison.OrdinalIgnoreCase)) { workbook = new XSSFWorkbook(new FileStream(filePath, FileMode.Open, FileAccess.Read)); } else if (Path.GetExtension(filePath).Equals(".xls", StringComparison.OrdinalIgnoreCase)) { workbook = new HSSFWorkbook(new FileStream(filePath, FileMode.Open, FileAccess.Read)); } else { throw new ArgumentException("不支持的文件格式"); } // 遍历所有工作表 for (int i = 0; i < workbook.NumberOfSheets; i++) { ISheet sheet = workbook.GetSheetAt(i); sheetNames.Add(sheet.SheetName); } return sheetNames; } catch (Exception ex) { // 记录异常（如日志） throw new InvalidOperationException("获取工作表名称失败", ex); } } }

注意事项与优化

• 文件路径：确保文件路径正确，支持相对路径和绝对路径。
• 大文件处理：对于大型Excel文件，可考虑流式读取（如MemoryStream），避免内存溢出。
• 性能优化：提前检查文件是否存在，减少无效操作。

库名称	适用场景	依赖	性能
Office Interop	.NET Framework，需Office安装	Office	高（但依赖Office）
EPPlus	.NET Framework，轻量级	无Office	中等
NPOI	.NET Core/Standard，无Office	无	高

常见问题解答

1. 如何处理只读Excel文件？

   在打开文件时添加FileMode.Open和FileAccess.Read，确保只读权限，若文件被锁定，抛出IOException，提示用户释放文件。

2. 如何获取工作表的其他属性？

   通过ISheet接口可获取行数、列数等信息：

   int rowCount = sheet.LastRowNum + 1; int colCount = sheet.GetRow(0)?.LastCellNum ?? 0;