ASP.NET DataTable 導出 Excel 完整方案：含檔案下載與編碼處理

方案概述

將 DataTable 資料導出為 Excel 檔案（.xls）是常見需求。本方案採用 DataGrid 渲染 HTML 表格，再透過 HttpResponse 輸出檔案流，支援中文檔名編碼、大檔案分塊傳輸與臨時檔清理。

核心導出方法

/// 

/// 將 DataTable 導出為 Excel 檔案並提供下載
/// 
/// 當前 Page 實例（取得 Response/Server）
/// 要導出的 DataTable
/// 下載檔名（含 .xls 副檔名）
public static void ExportToExcel(System.Web.UI.Page page, System.Data.DataTable dt, string fileName) {
    HttpResponse response = page.Response;

    // 1. 使用 DataGrid 渲染 HTML 表格
    System.Web.UI.WebControls.DataGrid dg = new System.Web.UI.WebControls.DataGrid();
    dg.DataSource = dt.DefaultView;
    dg.AllowPaging = false; // 關閉分頁，導出全部數據
    dg.HeaderStyle.BackColor = System.Drawing.Color.Green;
    dg.HeaderStyle.HorizontalAlign = HorizontalAlign.Center;
    dg.HeaderStyle.Font.Bold = true;
    dg.DataBind();

    // 2. 設定 HTTP 標頭：檔案下載、編碼、Content-Type
    response.Clear();
    response.Buffer = true;
    response.Charset = "GB2312"; // 舊版 Excel 相容性較好
    response.AppendHeader("Content-Disposition",
        "attachment;filename=" + HttpUtility.UrlEncode(fileName, System.Text.Encoding.UTF8));
    response.ContentEncoding = System.Text.Encoding.GetEncoding("GB2312");
    response.ContentType = "application/ms-excel";

    // 3. 將 DataGrid 渲染至 StringWriter
    System.IO.StringWriter sw = new System.IO.StringWriter();
    System.Web.UI.HtmlTextWriter hw = new System.Web.UI.HtmlTextWriter(sw);
    dg.RenderControl(hw);

    // 4. 可選：存檔至伺服器臨時路徑（若需二次處理）
    string tempPath = page.Server.MapPath("~/Files/") + fileName;
    System.IO.Directory.CreateDirectory(page.Server.MapPath("~/Files/"));
    System.IO.File.WriteAllText(tempPath, sw.ToString(), System.Text.Encoding.GetEncoding("GB2312"));

    // 5. 分塊輸出檔案流至客戶端（支援大檔案）
    DownloadFile(response, fileName, tempPath);

    response.End();
}

分塊下載輔助方法

private static bool DownloadFile(HttpResponse response, string fileName, string fullPath) {
    try {
        response.ContentType = "application/octet-stream";
        response.AppendHeader("Content-Disposition",
            "attachment;filename=" + HttpUtility.UrlEncode(fileName, System.Text.Encoding.UTF8) + ";charset=GB2312");

        using (System.IO.FileStream fs = System.IO.File.OpenRead(fullPath)) {
            long fileSize = fs.Length;
            int bufferSize = 102400; // 100KB 緩衝區
            byte[] buffer = new byte[bufferSize];
            long pos = 0;

            while (pos < fileSize) {
                int readSize = (int)Math.Min(bufferSize, fileSize - pos);
                if (readSize < bufferSize) buffer = new byte[readSize]; // 最後一塊調整大小
                fs.Read(buffer, 0, readSize);
                response.BinaryWrite(buffer);
                response.Flush(); // 關鍵：立即輸出，避免大檔案記憶體壓力
                pos += readSize;
            }
        }

        // 6. 清理臨時檔
        if (System.IO.File.Exists(fullPath)) System.IO.File.Delete(fullPath);
        return true;
    }
    catch {
        return false;
    }
}

關鍵技術點解析

進階替代方案建議

• EPPlus / NPOI / ClosedXML：產生真正的 .xlsx（OOXML 格式），支援樣式、公式、多工作表，適合複雜報表。
• StringBuilder 直輸出 HTML：省去 DataGrid 實例化開銷，適合極大數據量（百萬列以上）。
• 前端 JS 導出：如 SheetJS (xlsx.js) + FileSaver.js，將導出邏輯移至客戶端，減輕伺服器壓力。

常見問題排查

1. 導出檔案打開提示「格式不符」：確認 ContentType 為 application/ms-excel，且內容為 HTML 表格非二進位 Excel 格式。
2. 中文內容亂碼：檢查 ContentEncoding 與檔案實際編碼一致（GB2312/UTF-8）。
3. 大檔案導出超時：調整 httpRuntime executionTimeout 或改用分批導出/背景作業。