如何在C# ASP.NET中使用ClosedXML读取Excel特定行与指定单元格值

阿华AIGC实验室

2026-5-21

使用ClosedXML在C# ASP.NET中操作Excel的两个常见需求

没问题，这两个操作在ClosedXML里都很直观，结合ASP.NET的场景，我给你详细说明：

一、读取Excel的特定行

首先，确保你已经通过NuGet安装了ClosedXML包（可以在NuGet包管理器中搜索ClosedXML，或者用Package Manager Console执行Install-Package ClosedXML）。

在ASP.NET项目中，要注意文件路径的处理——尽量避免硬编码绝对路径，推荐使用IWebHostEnvironment来获取项目内的文件路径（比如wwwroot目录下的文件）。

以下是读取指定行的示例代码：

using ClosedXML.Excel;
using Microsoft.AspNetCore.Hosting;
using System.Collections.Generic;
using Microsoft.AspNetCore.Mvc;

// 假设你在控制器中注入了IWebHostEnvironment
private readonly IWebHostEnvironment _webHostEnv;

public YourController(IWebHostEnvironment webHostEnv)
{
    _webHostEnv = webHostEnv;
}

public IActionResult ReadSpecificRow()
{
    // 获取Excel文件的路径（示例：wwwroot下的ExcelFiles文件夹）
    string filePath = Path.Combine(_webHostEnv.WebRootPath, "ExcelFiles", "your-file.xlsx");

    // 使用using语句自动释放资源，避免内存泄漏
    using var workbook = new XLWorkbook(filePath);
    // 获取目标工作表（可以通过名称或索引，这里用第一个工作表）
    var worksheet = workbook.Worksheet(1);

    // 指定要读取的行号（比如第15行）
    int targetRowNum = 15;
    var targetRow = worksheet.Row(targetRowNum);

    // 遍历该行的所有已使用单元格（非空单元格）
    List<string> rowValues = new List<string>();
    foreach (var cell in targetRow.CellsUsed())
    {
        rowValues.Add(cell.Value.ToString());
    }

    // 这里可以根据业务需求处理rowValues，比如返回给前端或存入数据库
    return Ok(rowValues);
}

如果只需要该行中特定列的值，比如第4列（D列），可以直接这样获取：

var specificCell = targetRow.Cell(4);
string cellValue = specificCell.Value.ToString();

二、获取A12单元格的"foobar"值

获取单个指定单元格的值更简单，直接通过单元格地址或行列号定位即可，同样注意ASP.NET的路径处理：

using ClosedXML.Excel;
using Microsoft.AspNetCore.Hosting;
using Microsoft.AspNetCore.Mvc;

private readonly IWebHostEnvironment _webHostEnv;

public YourController(IWebHostEnvironment webHostEnv)
{
    _webHostEnv = webHostEnv;
}

public IActionResult GetA12Value()
{
    string filePath = Path.Combine(_webHostEnv.WebRootPath, "ExcelFiles", "your-file.xlsx");

    using var workbook = new XLWorkbook(filePath);
    var worksheet = workbook.Worksheet(1);

    // 方式1：通过单元格地址"A12"直接获取
    string a12Value = worksheet.Cell("A12").Value.ToString();

    // 方式2：通过行号12、列号1（A列是第1列）获取
    // string a12Value = worksheet.Row(12).Cell(1).Value.ToString();

    // 可选：判断单元格是否为空，避免空引用异常
    if (!worksheet.Cell("A12").IsEmpty())
    {
        a12Value = worksheet.Cell("A12").Value.ToString();
    }
    else
    {
        a12Value = "单元格为空";
    }

    return Ok($"A12单元格的值是：{a12Value}");
}