如何在无Azure/Graph API的ASP.NET Core Web API中更新网络驱动器Excel列

可行的.NET Core库选择 #

• Open XML SDK：原生支持Office文件操作，无需Excel授权，仅适配xlsx格式
• EPPlus：开源库，Excel操作逻辑更简洁，无需安装Excel，支持xlsx/xlsb格式（注：EPPlus 5+版本需商业授权，免费场景可选用4.x版本）
• NPOI：若需兼容旧版xls格式，可选用此库，同样无需依赖Excel环境

解决网络驱动器文件访问问题 #

你使用Open XML无法连接文件，核心原因大概率是权限或路径格式问题，需注意：

1. 放弃映射盘符（如Z:\），改用UNC路径（如\\server-name\shared-folder\target-file.xlsx）——映射盘符仅对当前登录用户有效，Web API的运行身份（如应用池账户、服务账户）无法识别
2. 确保Web API的运行账户拥有目标网络共享文件夹的读写权限，必要时可在应用池配置中指定具备权限的域账户

代码示例 #

1. 使用Open XML SDK更新指定列 #

先安装NuGet包：DocumentFormat.OpenXml

using DocumentFormat.OpenXml;
using DocumentFormat.OpenXml.Packaging;
using DocumentFormat.OpenXml.Spreadsheet;

public class ExcelUpdateService
{
    public void UpdateTargetColumn(string uncFilePath, string sheetName, int columnIndex, List<string> newValues)
    {
        // 以读写模式打开Excel文件
        using (SpreadsheetDocument doc = SpreadsheetDocument.Open(uncFilePath, true))
        {
            WorkbookPart workbookPart = doc.WorkbookPart;
            Sheet targetSheet = workbookPart.Workbook.Descendants<Sheet>().First(s => s.Name == sheetName);
            WorksheetPart worksheetPart = (WorksheetPart)workbookPart.GetPartById(targetSheet.Id);
            Worksheet worksheet = worksheetPart.Worksheet;

            // 从第2行开始更新（假设第1行为表头）
            int currentRow = 2;
            foreach (var value in newValues)
            {
                Row row = worksheet.Descendants<Row>().FirstOrDefault(r => r.RowIndex == currentRow);
                // 若目标行不存在，创建新行
                if (row == null)
                {
                    row = new Row { RowIndex = (uint)currentRow };
                    worksheet.Append(row);
                }

                // 定位目标列单元格，不存在则创建
                string columnLetter = ConvertColumnIndexToLetter(columnIndex);
                Cell targetCell = row.Descendants<Cell>().FirstOrDefault(c => c.CellReference.Value.StartsWith(columnLetter));
                if (targetCell == null)
                {
                    targetCell = new Cell { CellReference = $"{columnLetter}{currentRow}" };
                    row.Append(targetCell);
                }

                // 设置单元格值
                targetCell.CellValue = new CellValue(value);
                targetCell.DataType = new EnumValue<CellValues>(CellValues.String);

                currentRow++;
            }

            worksheet.Save();
        }
    }

    // 辅助方法：将列索引转为对应字母（1=A，2=B...）
    private string ConvertColumnIndexToLetter(int columnIndex)
    {
        string letter = string.Empty;
        while (columnIndex > 0)
        {
            int remainder = (columnIndex - 1) % 26;
            letter = Convert.ToChar(65 + remainder) + letter;
            columnIndex = (columnIndex - remainder) / 26;
        }
        return letter;
    }
}

2. 使用EPPlus更新指定列 #

安装NuGet包：EPPlus（4.x版本）

using OfficeOpenXml;
using System.IO;

public class ExcelUpdateService
{
    public void UpdateTargetColumn(string uncFilePath, string sheetName, int columnIndex, List<string> newValues)
    {
        // 配置非商业许可（仅4.x版本需此步骤）
        ExcelPackage.LicenseContext = LicenseContext.NonCommercial;

        using (var package = new ExcelPackage(new FileInfo(uncFilePath)))
        {
            ExcelWorksheet worksheet = package.Workbook.Worksheets[sheetName];
            int currentRow = 2; // 跳过表头行

            foreach (var value in newValues)
            {
                // EPPlus自动处理行/列不存在的情况
                worksheet.Cells[currentRow, columnIndex].Value = value;
                currentRow++;
            }

            package.Save();
        }
    }
}

ASP.NET Core Web API集成示例 #

[ApiController]
[Route("api/excel")]
public class ExcelController : ControllerBase
{
    private readonly ExcelUpdateService _excelService;

    public ExcelController(ExcelUpdateService excelService)
    {
        _excelService = excelService;
    }

    [HttpPost("update-column")]
    public IActionResult UpdateColumn([FromBody] ExcelUpdateRequest request)
    {
        try
        {
            _excelService.UpdateTargetColumn(request.UncFilePath, request.SheetName, request.ColumnIndex, request.NewValues);
            return Ok("列更新完成");
        }
        catch (Exception ex)
        {
            return BadRequest($"更新失败：{ex.Message}");
        }
    }
}

public class ExcelUpdateRequest
{
    public string UncFilePath { get; set; }
    public string SheetName { get; set; }
    public int ColumnIndex { get; set; }
    public List<string> NewValues { get; set; }
}

关键注意事项 #

• 文件锁定：处理文件时需确保无其他进程占用，否则会抛出IO异常
• 权限验证：部署前务必测试Web API运行账户对网络共享文件夹的读写权限
• 异常处理：建议增加文件不存在、工作表不存在等场景的捕获逻辑

内容的提问来源于stack exchange，提问作者patrick dempsy