萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> ASP.NET 程式設計

GridView 選擇性匯出 Excel 兩種方案完整比較與實作

需求:使用者在 GridView 勾選特定列,點擊「匯出所選」僅匯出勾選資料至 Excel。本文提供兩種方案完整比較:前端蒐集主鍵 → AJAX 傳遞 → 後端查詢匯出 與 後端直接遍歷 GridView 取值。

方案一:前端蒐集主鍵 + AJAX (適合大量資料、分頁場景)

前端 JavaScript (jQuery)

function exportSelected() {
    var selectedIds = [];
    // 遍歷 GridView 中的 CheckBox
    $('#<%= gvData.ClientID %> input[type="checkbox"].chkRow:checked').each(function() {
        // 假設主鍵放在隱藏欄位或 DataKey
        var row = $(this).closest('tr');
        var id = row.find('.hidden-id').val(); // 或 gvData.DataKeys[rowIndex].Value
        selectedIds.push(id);
    });

    if (selectedIds.length === 0) {
        alert('請至少選擇一筆資料');
        return false;
    }

    // AJAX POST 傳遞陣列
    $.post('<%= ResolveUrl("~/ExportHandler.ashx") %>', 
           { ids: selectedIds.join(',') }, 
           function(response) {
               // 處理檔案下載回應 (見下方 Handler 實作)
               window.location = '<%= ResolveUrl("~/Download.ashx") ?>?file=' + response.filename;
           });
    return false; // 阻止表單提交
}

後端 Generic Handler (ExportHandler.ashx)

public class ExportHandler : IHttpHandler
{
    public void ProcessRequest(HttpContext context)
    {
        string ids = context.Request["ids"]; // "1,5,12,23"
        if (string.IsNullOrEmpty(ids)) return;

        var idList = ids.Split(',').Select(int.Parse).ToList();
        var dt = GetDataByIds(idList); // 從 DB 查詢完整資料
        
        string fileName = $"Export_{DateTime.Now:yyyyMMdd_HHmmss}.xls";
        string filePath = context.Server.MapPath($"~/TempExports/{fileName}");
        Directory.CreateDirectory(Path.GetDirectoryName(filePath));
        
        ExportDataTableToExcel(dt, filePath); // 見下方通用匯出方法
        
        context.Response.ContentType = "application/json";
        context.Response.Write($"{{\"filename\":\"{fileName}\"}}");
    }

    private DataTable GetDataByIds(List<int> ids)
    {
        // 使用參數化 IN 查詢或 Table-Valued Parameter
        string sql = $"SELECT * FROM MyTable WHERE Id IN ({string.Join(",", ids)})";
        // ... 執行查詢填充 DataTable
    }

    private void ExportDataTableToExcel(DataTable dt, string filePath)
    {
        // 使用 NPOI / EPPlus / ClosedXML 產生真正 .xlsx (推薦)
        // 或舊式 HTML 表格輸出 (相容性佳但非真正 Excel)
    }
    public bool IsReusable => false;
}

方案二:後端直接遍歷 GridView (適合小資料量、無分頁、全資料已在 ViewState)

protected void btnExportSelected_Click(object sender, EventArgs e)
{
    var dt = new DataTable();
    // 建立欄位結構 (根據 GridView Columns 動態建立或固定)
    foreach (DataControlField col in gvData.Columns)
        if (col is BoundField bf) dt.Columns.Add(bf.DataField);

    foreach (GridViewRow row in gvData.Rows)
    {
        var chk = row.FindControl("chkRow") as CheckBox;
        if (chk != null && chk.Checked)
        {
            var dr = dt.NewRow();
            foreach (DataControlField col in gvData.Columns)
            {
                if (col is BoundField bf)
                    dr[bf.DataField] = row.Cells[gvData.Columns.IndexOf(col)].Text;
            }
            dt.Rows.Add(dr);
        }
    }

    if (dt.Rows.Count == 0) { ShowMsg("無勾選資料"); return; }
    ExportDataTableToExcel(dt, "SelectedExport.xls");
}

通用 Excel 匯出方法 (HTML 表格法,相容性最廣)

public void ExportDataTableToExcel(DataTable dt, string fileName)
{
    HttpContext.Current.Response.Clear();
    HttpContext.Current.Response.Charset = "UTF-8";
    HttpContext.Current.Response.ContentEncoding = System.Text.Encoding.UTF8;
    HttpContext.Current.Response.ContentType = "application/ms-excel";
    HttpContext.Current.Response.AddHeader("Content-Disposition", $"attachment;filename={HttpUtility.UrlEncode(fileName, Encoding.UTF8)}");

    // 防止科學記號、前導零消失
    string style = @"";
    HttpContext.Current.Response.Write(style);

    using (var sw = new StringWriter())
    using (var htw = new HtmlTextWriter(sw))
    {
        var dg = new DataGrid { DataSource = dt };
        dg.DataBind();
        dg.RenderControl(htw);
        HttpContext.Current.Response.Write(sw.ToString());
    }
    HttpContext.Current.Response.End();
}

方案比較與選擇建議

維度方案一:前端蒐集主鍵 + AJAX方案二:後端遍歷 GridView
資料完整性高 (重新從 DB 查詢最新資料)低 (僅限 GridView 顯示資料,可能非最新)
分頁支援完美 (跨頁選取合併主鍵)困難 (需遍歷所有分頁 ViewState 或關閉分頁)
效能 (大量資料)佳 (只傳主鍵,DB 查詢可優化)差 (ViewState 巨大、記憶體壓力大)
實作複雜度中 (需 Handler/Controller、AJAX、檔案下載協調)低 (累頁面事件即可完成)
適用場景正式專案、大量資料、分頁、需最新資料原型、小資料、無分頁、內部工具

現代化建議

  • 前端採用 Vue/React + Element Plus/Ant Design Table,勾選狀態由前端狀態管理,呼叫 Web API 匯出。
  • 後端使用 EPPlus / ClosedXML / NPOI 產生真正 .xlsx,支援樣式、公式、大數據流式寫入。
  • 大量匯出 (>1萬列) 應採用背景任務 + 檔案下載連結通知模式,避免請求逾時。

選擇方案一為企業級應用標準做法,方案二適合快速原型或受限環境。

copyright © 萬盛學電腦網 all rights reserved