ASP.NET 導出 GridView 到 Word 避免導出 TextBox 控件

問題現象

使用 GridView.RenderControl() 導出 Word 時，模板列中的 TextBox 控件被渲染為 HTML ``，導出文檔中顯示為輸入框而非純文本。

核心原因

RenderControl 會递归渲染控件樹的完整 HTML，包含輸入控件的標簽結構。Word 打開 HTML 時解析為表單字段。

解決方案對比

方案一完整實現代碼 (推薦)

protected void btnExportWord_Click(object sender, EventArgs e) {
    // 1. 保存原始控件引用以便恢復 (若頁面需繼續編輯)
    // 實際上導出後通常 Redirect 或結束響應，無需恢復
    
    // 2. 遍歷行，將 TextBox 替換為 Label 顯示純文本
    foreach (GridViewRow row in GridView1.Rows) {
        if (row.RowType == DataControlRowType.DataRow) {
            // 假設第 2 列是模板列包含 TextBox
            TextBox txt = row.FindControl("txtName") as TextBox; // 你的 TextBox ID
            if (txt != null) {
                Label lbl = new Label();
                lbl.Text = txt.Text;
                lbl.CssClass = txt.CssClass; // 保留樣式類
                // 替換控件
                int cellIndex = 1; // 列索引
                TableCell cell = row.Cells[cellIndex];
                cell.Controls.Clear();
                cell.Controls.Add(lbl);
            }
        }
    }
    
    // 3. 導出邏輯 (原代碼基本不變)
    Response.Clear();
    Response.Buffer = true;
    Response.Charset = "UTF-8";
    Response.AppendHeader("Content-Disposition", "attachment;filename=Export.doc");
    Response.ContentEncoding = System.Text.Encoding.GetEncoding("UTF-8");
    Response.ContentType = "application/ms-word";
    
    EnableViewState = false;
    using (StringWriter sw = new StringWriter())
    using (HtmlTextWriter hw = new HtmlTextWriter(sw)) {
        GridView1.RenderControl(hw);
        Response.Output.Write(sw.ToString());
    }
    Response.Flush();
    Response.End();
}

// 必須重寫 VerifyRenderingInServerForm 允許 GridView 在非表單中渲染
public override void VerifyRenderingInServerForm(Control control) { }

方案二：NPOI 生成真實 .xls/.xlsx (更專業)

// NuGet: Install-Package NPOI
protected void btnExportExcel_Click(object sender, EventArgs e) {
    IWorkbook workbook = new XSSFWorkbook(); // .xlsx
    ISheet sheet = workbook.CreateSheet("數據");
    
    // 標題行
    IRow headerRow = sheet.CreateRow(0);
    for (int i = 0; i < GridView1.Columns.Count; i++) {
        headerRow.CreateCell(i).SetCellValue(GridView1.Columns[i].HeaderText);
    }
    
    // 數據行
    for (int r = 0; r < GridView1.Rows.Count; r++) {
        GridViewRow gvRow = GridView1.Rows[r];
        if (gvRow.RowType != DataControlRowType.DataRow) continue;
        IRow dataRow = sheet.CreateRow(r + 1);
        for (int c = 0; c < GridView1.Columns.Count; c++) {
            string cellText = "";
            // 獲取純文本：優先找控件 Text，否則取單元格文本
            Control ctrl = gvRow.Cells[c].Controls[0]; // 簡化，實際需遞歸查找
            if (ctrl is TextBox) cellText = ((TextBox)ctrl).Text;
            else if (ctrl is Label) cellText = ((Label)ctrl).Text;
            else cellText = gvRow.Cells[c].Text; // 可能包含  
            
            dataRow.CreateCell(c).SetCellValue(cellText.Trim());
        }
    }
    
    // 自適應列寬
    for (int i = 0; i < GridView1.Columns.Count; i++) sheet.AutoSizeColumn(i);
    
    // 輸出
    Response.Clear();
    Response.ContentType = "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet";
    Response.AppendHeader("Content-Disposition", "attachment;filename=Export.xlsx");
    using (MemoryStream ms = new MemoryStream()) {
        workbook.Write(ms);
        Response.BinaryWrite(ms.ToArray());
    }
    Response.End();
}

最佳實踐建議

1. 優先使用 NPOI/Open XML SDK 生成原生 Office 格式，避免 HTML 渲染差異，支持複雜樣式、公式、圖片。
2. 若必須用 HTML 導出 Word，導出前徹底清洗控件樹：移除所有輸入控件、驗證控件、腳本標簽，僅保留純文本顯示控件 (Label/Literal/Span)。
3. 不要在服務器端自動化 Word/Excel (COM 組件)，極不穩定、有安全風險、不支持併發。
4. 導出按鈕觸發 完整 PostBack (非 UpdatePanel 異步)，否則 Response.End() 會導致異常。