Ajax 的原始精神,是讓開發者以非同步方式取得 XML 內容,从而实现不刷新頁面的效果。ASP.NET AJAX 把底層細節封裝起來之後,這件事比手寫 XMLHttpRequest 輕扶手得多,尤其在跨瀏覽器相容性上,框架已經替我們處理掉大半。
以下依 ASP.NET AJAX 官方範例的思維,說明如何以 Microsoft AJAX Library 的 WebRequest 物件取得一份 XML 文件。
function GetXML() {
// 建立 WebRequest 物件
var wRequest = new Sys.Net.WebRequest();
// 指定要請求的檔案
wRequest.set_url("index.xml");
// 註冊完成後的處理常式
wRequest.add_completed(OnSucceededXML);
// 清空結果區
if (document.all)
resultElementId.innerText = "";
else
resultElementId.textContent = ""; // Firefox
// 送出請求
wRequest.invoke();
}
function OnSucceededXML(executor, eventArgs) {
if (executor.get_responseAvailable()) {
if (document.all) {
resultElementId.innerText += executor.get_xml().xml;
} else {
// Firefox
resultElementId.textContent += "First node: "
+ executor.get_xml().documentElement.nodeName;
}
} else {
if (executor.get_timedOut())
alert("逾時");
else if (executor.get_aborted())
alert("失敗");
}
}
<button id="Button3" type="button">XML</button>
<div id="ResultId" style="background-color:Aqua;"></div>
三個環節拼起來就是完整的流程:WebRequest 指定 URL 並掛上 completed 事件,invoke() 送出請求,executor 物件則提供 get_responseAvailable()、get_xml()、get_timedOut()、get_aborted() 等方法,讓我們能清楚分辨成功、逾時與中止三種結局。
傳統寫法要自己判斷 readyState 與 status,還得處理 ActiveX 與原生物件的差異;改用 Sys.Net.WebRequest 之後,這些判斷被收斂成語意化的方法呼叫,程式碼意圖清楚,也不易漏掉逾時與中止的分支。
需要注意的是 DOM 操作仍要分瀏覽器:IE 走 innerText,Firefox 走 textContent。若要徹底擺脫這類條件判斷,可改用 Sys.getElement() 搭配 AJAX Control Toolkit,或直接以 jQuery 的 text() 統一處理。