在傳統的 ASP.NET WebForm 開發裡,只要按下任何一個 Button,整頁就會被送回伺服器、重新渲染、再整份回傳。畫面閃一下、輸入框被清空、捲軸跳回頂端——這些惱人的細節,往往比真正想呈現的資料更讓使用者分心。
MagicAjax 提供的 AjaxPanel 就是為了解掉這個問題而生。它的用法極為直覺:只要在頁面中把 AjaxPanel 當成父容器,被它包住的子控制項在執行期就自動具備無回發(no-refresh)能力。實測下來效果相當俐落,設定成本也很低。

第一步是把控制項加入 Visual Studio 的工具箱,之後就能像一般伺服器控制項那樣拖曳使用:


接著在 Web.config 的 <configuration> 節點中註冊 MagicAjax 的組態區段與參數:
<configSections>
<section name="magicAjax"
type="MagicAjax.Configuration.MagicAjaxSectionHandler, MagicAjax" />
</configSections>
<magicAjax outputCompareMode="HashCode" tracing="false">
<pageStore mode="NoStore" unloadStoredPage="false"
cacheTimeout="5" maxConcurrentPages="5" maxPagesLimitAlert="false"/>
</magicAjax>
再於 <system.web> 中掛上 HTTP Module,攔截並改寫相關請求與回應:
<system.web>
<httpModules>
<add name="MagicAjax" type="MagicAjax.MagicAjaxModule, MagicAjax"/>
</httpModules>
</system.web>
設定完成後,使用方式就跟寫普通 WebForm 一樣。以下範例把一個 Panel 與一顆 Button 放進 AjaxPanel,按下按鈕後只更新容器內的內容:
<body>
<form id="form1" runat="server">
<div>
<ajax:AjaxPanel ID="AjaxPanel1" runat="server" Font-Bold="True">
<asp:Panel ID="Panel1" runat="server" Font-Size="XX-Large"
Height="45px" Width="273px">
AjaxPanel example
</asp:Panel>
<br />
<asp:Button ID="Button1" runat="server" BackColor="#FFC080"
Height="26px" Width="273px" Text="Button" />
</ajax:AjaxPanel>
</div>
</form>
</body>
AjaxPanel 的價值在於「用容器劃界」,因此有幾個眉角值得先想清楚:
整體來說,對於既有的 WebForm 專案,AjaxPanel 提供了一條改造成本極低的 Ajax 化路徑——不必推翻原架構,只要把要局部更新的區塊包起來即可。