簡單介紹
Ajax(Asynchronous JavaScript + XML)應用的特點是只向伺服器送出並取回真正需要的資料。它使用 SOAP 或其它基於 XML 的 Web Service 介面,並在用戶端以 JavaScript 處理回應。由於伺服器與瀏覽器之間交換的資料量大幅減少,使用者感受到的就是更快的反應;同時許多運算改在發出請求的那一端完成,伺服器的負擔也跟著降低。
Ajax 應用的優勢可以歸納為三點:
兩個版本的差異
Ajax.Net 有 AjaxPro.dll 與 Ajax.dll 兩個版本,使用方式大致相同,但有兩處關鍵差異——很多人「找不到命名空間」或「物件未定義」,其實就是栽在這裡。
第一,web.config 的設定寫法不同。Ajax.dll:
<add verb="POST,GET" path="ajax/*.ashx" type="Ajax.PageHandlerFactory, Ajax" />
AjaxPro.dll:
<add verb="*" path="ajaxpro/*.ashx" type="AjaxPro.AjaxHandlerFactory, AjaxPro" />
第二,呼叫伺服器方法時要不要帶命名空間不同。使用 Ajax.dll 時不加命名空間;使用 AjaxPro.dll 時必須加上完整命名空間。例如頁面宣告如下:
<%@ Page language="c#" Codebehind="Test.aspx.cs"
AutoEventWireup="false" Inherits="Web.Test" %>
那麼用戶端的呼叫寫法就是:
// Ajax.dll var response = Test.GetServerMethod(); alert(response.value); // AjaxPro.dll var response = Web.Test.GetServerMethod(); alert(response.value);
具體使用步驟
步驟一:下載 AjaxPro 元件,將 AjaxPro.dll 加入網站(或專案)的參考。
步驟二:修改 Web.config,在 <system.web> 元素中註冊 HTTP 處理常式:
<configuration>
<system.web>
<httpHandlers>
<!-- 註冊 Ajax 處理常式 -->
<add verb="*" path="ajaxpro/*.ashx"
type="AjaxPro.AjaxHandlerFactory, AjaxPro" />
</httpHandlers>
</system.web>
</configuration>
步驟三:在頁面的 Page_Load 事件中進行執行階段註冊:
protected void Page_Load(object sender, EventArgs e)
{
// 這裡的 _Default 是指頁面類別的類名。
// 若放在命名空間內,則需寫上完整的命名空間,例如 Namespaces._Default
AjaxPro.Utility.RegisterTypeForAJax(typeof(_Default));
}
步驟四:建立伺服器端方法。只要為方法加上 [AjaxPro.AjaxMethod] 標記,它就成為 AjaxPro 可供映射呼叫的方法:
[AjaxPro.AjaxMethod]
public string getValue(int a, int b)
{
// 這個方法將實作:從用戶端傳入兩個數字,
// 在伺服器端相加計算後回傳給用戶端
return Convert.ToString(a + b);
}
步驟五:用戶端呼叫。
<script language="Javascript">
function getValue() {
// 呼叫伺服器端的 _Default.getValue 方法。
// 這裡需要指定一個回呼函式,用來接收伺服器處理完畢後傳回的結果
_Default.getValue(1, 2, getGroups_callback);
form1.TextBox1.value = "123";
}
// 這個方法用來接收並處理伺服器端傳回的結果
function getGroups_callback(response) {
var dt = response.value;
alert(dt);
}
</script>
幾個實務上的提醒
回呼函式的命名規則是「方法名 + _callback」,少了這個後綴就不會被觸發,這是除錯時最常見的盲點之一。另外,AjaxPro 產生的用戶端腳本依賴一個 runat="server" 的表單來注入通用函式,若頁面上沒有這個表單,就得手動補上相關的 script 參照,否則呼叫時會出現物件未定義的錯誤。
最後要留意安全性:加上 [AjaxMethod] 就等於把該方法公開給用戶端呼叫,因此只應該標記在「即使被任意呼叫也不會造成風險」的方法上,涉及權限或敏感資料的操作仍應在伺服器端另外驗證。