.NET怎么将查询结果导出为Excel文件

来源：这里教程网时间：2026-02-21 17:30:29 作者：

在 .NET 项目中将查询结果导出为 Excel 文件，通常可以通过以下步骤实现：获取数据、构建 Excel 文件、写入数据并提供下载。推荐使用 EPPlus 或 NPOI 这两个流行的库来操作 Excel 文件（.xlsx 格式）。

1. 安装 EPPlus 库

EPPlus 是一个功能强大且易于使用的库，支持读写 .xlsx 文件。通过 NuGet 安装：在包管理器控制台运行：
Install-Package EPPlus

2. 查询数据并导出为 Excel

假设你从数据库查询出一个 List 对象，例如用户列表： 创建一个方法，接收数据并生成 Excel 文件的字节数组 使用
ExcelPackage
来创建工作簿和工作表 将数据逐行写入工作表

示例代码：

using OfficeOpenXml;
using System.Collections.Generic;
using System.IO;
public byte[] ExportToExcel(List<User> users)
{
    ExcelPackage.LicenseContext = LicenseContext.NonCommercial; // 设置许可证上下文
    using (var package = new ExcelPackage())
    {
        var worksheet = package.Workbook.Worksheets.Add("Users");
        // 写入标题行
        worksheet.Cells[1, 1].Value = "ID";
        worksheet.Cells[1, 2].Value = "姓名";
        worksheet.Cells[1, 3].Value = "邮箱";
        // 写入数据行
        for (int i = 0; i < users.Count; i++)
        {
            worksheet.Cells[i + 2, 1].Value = users[i].Id;
            worksheet.Cells[i + 2, 2].Value = users[i].Name;
            worksheet.Cells[i + 2, 3].Value = users[i].Email;
        }
        // 可选：自动调整列宽
        worksheet.Cells[worksheet.Dimension.Address].AutoFitColumns();
        return package.GetAsByteArray();
    }
}

3. 在 ASP.NET Core 中返回文件

如果你在 Web 项目中使用，可以通过控制器返回文件：

[HttpGet("export")]
public IActionResult ExportUsers()
{
    var users = _context.Users.ToList(); // 示例：从 EF 获取数据
    var fileBytes = ExportToExcel(users);
    var fileName = "Users.xlsx";
    return File(fileBytes, "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet", fileName);
}

4. 注意事项

确保设置
LicenseContext
，否则 EPPlus 在某些环境下会抛出异常 对于大型数据集，考虑分页或流式写入以避免内存溢出 若需兼容 .xls（旧格式），可使用 NPOI 替代 EPPlus 生产环境注意异常处理和文件名编码（尤其是中文） 基本上就这些。用 EPPlus 导出 Excel 简单高效，适合大多数 .NET 场景。