在.NET项目开发过程中，将查询结果导出为Excel文件是非常常见的需求，无论是后台管理系统的数据报表下载，还是业务数据的离线存档，都需要用到这个功能。实现这个需求可以选择多种方案，其中使用EPPlus库是最便捷高效的方式之一，它不需要依赖本地安装Excel软件，就能完成Excel文件的读写操作。
前期准备
首先需要安装EPPlus库，如果你使用的是Visual Studio，可以在NuGet包管理器中搜索EPPlus进行安装，也可以通过命令行执行以下命令：
dotnet add package EPPlus
安装完成后，就可以在项目中引入对应的命名空间：
using OfficeOpenXml; using System.IO; using System.Collections.Generic;
核心实现步骤
1. 准备查询数据
这里先模拟一组查询得到的结果数据，实际项目中你可以替换为从数据库查询返回的List集合或者DataTable：
// 模拟用户查询的结果集合
public class UserInfo
{
public int Id { get; set; }
public string UserName { get; set; }
public int Age { get; set; }
public string Email { get; set; }
}
List<UserInfo> queryResult = new List<UserInfo>
{
new UserInfo { Id = 1, UserName = "张三", Age = 25, Email = "zhangsan@ipipp.com" },
new UserInfo { Id = 2, UserName = "李四", Age = 28, Email = "lisi@ipipp.com" },
new UserInfo { Id = 3, UserName = "王五", Age = 30, Email = "wangwu@ipipp.com" }
};
2. 编写导出Excel的核心代码
下面的代码实现了将查询结果写入Excel文件，并输出为文件流的逻辑，适用于Web项目或者桌面项目：
public byte[] ExportQueryResultToExcel(List<UserInfo> data)
{
// 设置EPPlus的非商业许可（如果是商业项目需要购买正式许可）
ExcelPackage.LicenseContext = LicenseContext.NonCommercial;
using (ExcelPackage package = new ExcelPackage())
{
// 创建一个工作表，命名为"用户数据"
ExcelWorksheet worksheet = package.Worksheets.Add("用户数据");
// 设置表头
worksheet.Cells[1, 1].Value = "用户ID";
worksheet.Cells[1, 2].Value = "用户名";
worksheet.Cells[1, 3].Value = "年龄";
worksheet.Cells[1, 4].Value = "邮箱";
// 填充数据行
for (int i = 0; i < data.Count; i++)
{
int row = i + 2; // 从第2行开始填充数据，第1行是表头
worksheet.Cells[row, 1].Value = data[i].Id;
worksheet.Cells[row, 2].Value = data[i].UserName;
worksheet.Cells[row, 3].Value = data[i].Age;
worksheet.Cells[row, 4].Value = data[i].Email;
}
// 自动调整列宽，让内容显示更完整
worksheet.Cells[worksheet.Dimension.Address].AutoFitColumns();
// 返回Excel文件的字节数组
return package.GetAsByteArray();
}
}
3. 不同场景下的使用方式
Web项目（ASP.NET Core）中返回文件下载
如果是Web项目，可以直接将生成的字节数组返回为文件下载响应：
[HttpGet]
public IActionResult DownloadExcel()
{
// 获取查询数据（这里替换为你的实际查询逻辑）
List<UserInfo> data = GetQueryResult();
byte[] fileBytes = ExportQueryResultToExcel(data);
string fileName = "用户数据导出.xlsx";
return File(fileBytes, "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet", fileName);
}
// 模拟查询数据的方法
private List<UserInfo> GetQueryResult()
{
return new List<UserInfo>
{
new UserInfo { Id = 1, UserName = "张三", Age = 25, Email = "zhangsan@ipipp.com" },
new UserInfo { Id = 2, UserName = "李四", Age = 28, Email = "lisi@ipipp.com" }
};
}
桌面项目保存文件到本地
如果是WinForm或者WPF项目，可以将字节数组保存到指定路径：
public void SaveExcelToLocal(List<UserInfo> data, string filePath)
{
byte[] fileBytes = ExportQueryResultToExcel(data);
File.WriteAllBytes(filePath, fileBytes);
}
注意事项
- EPPlus从版本5开始需要设置LicenseContext，非商业项目可以设置为NonCommercial，商业项目需要购买正式许可。
- 如果查询结果是DataTable类型，可以先遍历DataTable的行和列来填充Excel，逻辑和List集合类似。
- 导出日期、金额等特殊格式的数据时，可以通过设置单元格的格式来保证显示正确，例如设置日期格式：
worksheet.Cells[row, column].Style.Numberformat.Format = "yyyy-MM-dd"; - 如果数据量非常大，建议分批次写入或者分多个工作表存储，避免内存占用过高。