ASP.NET GridView导出.xlsx文件失败，寻求技术帮助

问题根源分析 #

1. 旧的.xls导出方法依赖OLE驱动，不适用于OpenXML格式的.xlsx，强行套用会导致流操作错误。
2. 流操作时未重置MemoryStream的位置，导致读取到空内容。
3. Response头配置不正确，浏览器无法识别为下载文件，因此不弹出“另存为”对话框。

解决方案（使用EPPlus库） #

EPPlus是专门处理OpenXML格式Excel的开源库，适配ASP.NET环境，步骤如下：

1. 安装EPPlus：通过NuGet包管理器安装EPPlus（.NET Framework选4.x版本，.NET Core/5+选5+版本）。

2. 按钮点击事件代码

protected void btnExportToExcel_Click(object sender, EventArgs e)
{
    // 若GridView启用分页，先关闭分页导出全部数据
    GridView1.AllowPaging = false;
    GridView1.DataBind();

    using (var excelPackage = new ExcelPackage())
    {
        // 创建工作表
        var worksheet = excelPackage.Workbook.Worksheets.Add("导出数据");

        // 写入表头
        for (int colIndex = 0; colIndex < GridView1.HeaderRow.Cells.Count; colIndex++)
        {
            worksheet.Cells[1, colIndex + 1].Value = GridView1.HeaderRow.Cells[colIndex].Text;
            worksheet.Cells[1, colIndex + 1].Style.Font.Bold = true;
        }

        // 写入数据行
        for (int rowIndex = 0; rowIndex < GridView1.Rows.Count; rowIndex++)
        {
            for (int colIndex = 0; colIndex < GridView1.Rows[rowIndex].Cells.Count; colIndex++)
            {
                worksheet.Cells[rowIndex + 2, colIndex + 1].Value = GridView1.Rows[rowIndex].Cells[colIndex].Text;
            }
        }

        // 自动调整列宽
        worksheet.Cells.AutoFitColumns();

        // 配置Response触发浏览器下载
        Response.Clear();
        Response.ContentType = "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet";
        Response.AddHeader("Content-Disposition", $"attachment; filename=GridView导出_{DateTime.Now:yyyyMMddHHmmss}.xlsx");

        // 将Excel内容写入Response
        using (var memoryStream = new MemoryStream())
        {
            excelPackage.SaveAs(memoryStream);
            memoryStream.Position = 0; // 重置流位置到开头，确保能读取全部内容
            memoryStream.CopyTo(Response.OutputStream);
        }

        Response.Flush();
        Response.End();
    }
}

关键修正点说明 #

• 流位置重置：memoryStream.Position = 0确保从流的起始位置读取内容，避免生成空文件。
• 正确的Response头：Content-Type使用.xlsx专属的MIME类型，Content-Disposition设为attachment强制浏览器触发下载弹窗。
• 使用OpenXML专用库：EPPlus原生支持.xlsx格式，避免旧方法的兼容性问题。

额外注意事项 #

• 如果需要导出隐藏列，需在绑定数据前设置GridView1.Columns[索引].Visible = true。
• 若使用EPPlus 5+版本，需在代码开头添加ExcelPackage.LicenseContext = LicenseContext.NonCommercial;（非商用场景）。

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