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

使用EPPlus或NPOI库可实现.NET中数据库查询结果导出Excel,EPPlus适用于.xlsx格式,通过DataTable填充数据并写入ExcelPackage;NPOI支持.xls和.xlsx,兼容性更强且免费开源;大数据量时建议分页查询、流式写入或导出CSV以提升性能,Web场景下通过内存流返回文件供下载。

在.NET开发中,将数据库查询结果导出为Excel文件是一个常见的需求,比如用于报表导出、数据分析等场景。实现这一功能并不复杂,关键是选择合适的库并正确组织数据。以下是具体操作方法和步骤。

使用EPPlus库导出查询结果到Excel

EPPlus 是一个功能强大且广泛使用的 .NET 库,支持读写 Excel 2007 及以上版本(.xlsx 格式),非常适合处理从数据库查询出来的数据。

步骤如下:

  • 通过 NuGet 安装 EPPlus:在项目中运行 Install-Package EPPlus 命令。
  • 执行 SQL 查询获取数据,可以使用 ADO.NET 或 Entity Framework。
  • 创建一个 MemoryStream 和 ExcelPackage 实例。
  • 将查询结果填充到 DataTable 或 List 对象中。
  • 将数据写入 Excel 工作表的单元格。
  • 设置响应头,输出文件供用户下载(适用于 Web 应用)。

示例代码(ASP.NET Core 中):

using OfficeOpenXml;
using System.Data;

public IActionResult ExportToExcel()
{
    // 模拟查询结果
    var dataTable = new DataTable();
    dataTable.Columns.Add("ID", typeof(int));
    dataTable.Columns.Add("Name", typeof(string));
    dataTable.Rows.Add(1, "张三");
    dataTable.Rows.Add(2, "李四");

    using (var package = new ExcelPackage())
    {
        var worksheet = package.Workbook.Worksheets.Add("数据表");
        worksheet.Cells["A1"].LoadFromDataTable(dataTable, true);

        var stream = new MemoryStream();
        package.SaveAs(stream);
        stream.Position = 0;

        string fileName = "查询结果.xlsx";
        return File(stream, "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet", fileName);
    }
}

使用 NPOI 处理兼容性更高的 Excel 导出

如果你需要支持老版本 Excel(.xls)或部署环境限制使用 EPPlus(如非商业用途免费但有许可证注意点),NPOI 是一个优秀的开源替代方案。

特点:

  • 完全免费,开源,兼容 .NET Framework 和 .NET Core/5+。
  • 支持 xls 和 xlsx 格式。
  • API 类似于 Java 的 POI 项目,学习曲线稍陡但功能全面。

基本流程:

  • NuGet 安装:Install-Package NPOI
  • 创建 HSSFWorkbook(xls)或 XSSFWorkbook(xlsx)对象。
  • 添加 Sheet,并逐行写入查询结果。
  • 通过 Response 输出文件(Web 场景)或保存到磁盘(桌面应用)。

处理大数据量时的优化建议

当查询结果非常大时(如十万行以上),直接加载到内存可能导致性能问题或内存溢出。

推荐做法:

  • 采用分页查询方式,每次读取一部分数据写入 Excel。
  • 使用流式写入,避免一次性加载全部数据。
  • 考虑生成 CSV 文件作为替代方案,CSV 更轻量,打开速度快,适合纯数据导出。
  • 在后台任务中执行导出,通过消息队列通知用户下载完成。

基本上就这些。选择 EPPlus 还是 NPOI 取决于你的项目需求和许可要求,两者都能很好地完成查询结果导出 Excel 的任务。关键在于把数据库数据正确映射到表格结构,并确保用户体验流畅。