使用EPPlus库可将.NET中查询结果导出为Excel:先安装EPPlus,再通过ExcelPackage创建工作簿并写入数据,最后在ASP.NET Core中返回文件流,适用于大多数Web场景。

在 .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(Listusers) { 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
- 生产环境注意异常处理和文件名编码(尤其是中文)










