在 Ajax 環境中,Excel 沒辦法再照舊方式匯出。原因很直接:非同步模式下呼叫 Response.Write 會出錯,而匯出 Excel 本質上就是直接改寫回應串流。
解法是在頁面載入時把匯出按鈕註冊為同步觸發器,也就是不要讓它被包在 UpdatePanel 的非同步更新裡。同時,這個按鈕也不能註冊進 UpdatePanel 的更新範圍,兩點都做到即可解決。(這個方式對 Visual Studio 自帶的 Ajax 有效;網路上大量第三方 Ajax 框架的匯出方案與此不同。)
protected void Page_Load(object sender, EventArgs e)
{
// 把匯出按鈕註冊為同步回傳觸發器
PostBackTrigger trigger = new PostBackTrigger();
trigger.ControlID = "btn_export";
((UpdatePanel)Page.Controls[0].FindControl("UpdatePanel1")).Triggers.Add(trigger);
}
// 必須覆寫此方法,否則執行時會出現:
// 「類型 GridView 的控制項 GridView1 必須放在具有 runat=server 的表單標記內」
public override void VerifyRenderingInServerForm(Control control)
{
// intentionally left empty
}
為什麼要覆寫 VerifyRenderingInServerForm?因為匯出時我們會把 GridView 渲染成字串寫進回應串流,而 GridView 產生的 HTML 並不位於表單標籤內,基類的檢查就會攔下它。這個檢查原本是用來防止某些只有在表單內才正常運作的控件被放到表單外,在匯出情境下我們明知並故意繞過,所以空實作是合理的。
注意 <Triggers> 區塊是空的——按鈕雖然寫在 ContentTemplate 裡,但因為已在後端註冊為 PostBackTrigger,它就不會走非同步路線。
<asp:UpdatePanel ID="UpdatePanel1" runat="server">
<ContentTemplate>
<asp:Button ID="btn_export" runat="server" Text="匯出"
CssClass="button100" Width="80px" OnClick="Button6_Click" />
<asp:GridView ID="gv_oil" runat="server"
CellPadding="4" ForeColor="#333333" GridLines="None" Width="100%"
AutoGenerateColumns="False">
<HeaderStyle BackColor="#507CD1" Font-Bold="True" ForeColor="White" />
<RowStyle BackColor="#EFF3FB" />
<AlternatingRowStyle BackColor="White" />
<FooterStyle BackColor="#507CD1" Font-Bold="True" ForeColor="White" />
</asp:GridView>
</ContentTemplate>
<Triggers>
</Triggers>
</asp:UpdatePanel>
如果不想動 UpdatePanel 的觸發器設定,也可以把匯出邏輯抽到一個獨立的 .aspx 頁面,用 window.open() 或 window.location 直接導向它。那個頁面不掛任何 Ajax 控件,回應串流的寫法就跟傳統 Web Forms 完全一樣,不必覆寫 VerifyRenderingInServerForm,也省下與 UpdatePanel 交手的麻煩。頁面結構清楚的專案裡,這個做法通常更好維護。
另外提醒,若 GridView 有分頁或排序,匯出前記得先確認資料來源是完整的、而非只有當前頁。