使用ClosedXML导出GridView到Excel时列名显示异常问题求助

当你的GridView启用了排序功能（AllowSorting="True"）时，表头单元格（HeaderRow.Cells）中的内容并非直接的文本，而是被ASP.NET自动包装成了LinkButton控件。此时直接读取TableCell.Text会得到空值或无效内容，导致你创建的DataTable没有正确设置列名，ClosedXML只能使用默认的Column1、Column2等命名。

有两种可靠的方式可以获取正确的表头文本：

方法1：直接从GridView的Columns集合读取HeaderText #

跳过读取HeaderRow，直接遍历GridView的Columns集合，取出每个BoundField的HeaderText来创建DataTable的列，这种方法更稳定，不受表头控件类型影响：

protected void ExportExcel(object sender, EventArgs e)
{
    DataTable dt = new DataTable("GridView_Data");
    // 直接从Columns集合获取表头文本
    foreach (DataControlField col in GridView1.Columns)
    {
        dt.Columns.Add(col.HeaderText);
    }

    foreach (GridViewRow row in GridView1.Rows)
    {
        dt.Rows.Add();
        for (int i = 0; i < row.Cells.Count; i++)
        {
            // 处理单元格内容，兼容不同控件类型
            string cellText = string.Empty;
            if (row.Cells[i].Controls.Count > 0 && row.Cells[i].Controls[0] is DataBoundLiteralControl)
            {
                cellText = ((DataBoundLiteralControl)row.Cells[i].Controls[0]).Text.Trim();
            }
            else
            {
                cellText = row.Cells[i].Text.Trim();
            }
            dt.Rows[dt.Rows.Count - 1][i] = cellText;
        }
    }

    using (XLWorkbook wb = new XLWorkbook())
    {
        wb.Worksheets.Add(dt);
        Response.Clear();
        Response.Buffer = true;
        Response.Charset = "";
        Response.ContentType = "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet";
        // 修正文件名格式，避免特殊字符
        string fileName = $"Group_Members_{DateTime.Now:yyyyMMddHHmmss}.xlsx";
        Response.AddHeader("content-disposition", $"attachment;filename={fileName}");
        using (MemoryStream MyMemoryStream = new MemoryStream())
        {
            wb.SaveAs(MyMemoryStream);
            MyMemoryStream.WriteTo(Response.OutputStream);
            Response.Flush();
            Response.End();
        }
    }
}

方法2：从HeaderRow的控件中提取文本 #

如果一定要从HeaderRow读取，需要判断单元格中的控件类型，取出LinkButton的Text属性：

protected void ExportExcel(object sender, EventArgs e)
{
    DataTable dt = new DataTable("GridView_Data");
    foreach (TableCell cell in GridView1.HeaderRow.Cells)
    {
        string headerText = string.Empty;
        // 判断是否是排序用的LinkButton
        if (cell.Controls.Count > 0 && cell.Controls[0] is LinkButton)
        {
            headerText = ((LinkButton)cell.Controls[0]).Text;
        }
        else
        {
            headerText = cell.Text;
        }
        dt.Columns.Add(headerText);
    }

    // 后续行处理和Excel导出代码与原逻辑一致，此处省略
}

• 文件名中的DateTime.Now会包含冒号（:），部分系统会识别为非法字符，建议格式化日期为yyyyMMddHHmmss这种无特殊字符的格式，避免下载时出现问题。
• 如果GridView中有模板列，需要根据模板内的控件类型（如Label、TextBox等）来读取对应的值，确保导出内容完整。

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