在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包管理器安装：

   Install-Package NPOI

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），避免内存溢出。
• 性能优化：提前检查文件是否存在，减少无效操作。

常见问题解答

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

2. 如何获取工作表的其他属性？
   通过ISheet接口可获取行数、列数等信息：

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