呼叫客戶端代理時多帶一個參數,就能指定處理伺服器回應的函數:
Sample.ServerSideAdd(100, 99, ServerSideAdd_CallBack);
function ServerSideAdd_CallBack(response) {
if (response.error != null) {
alert(response.error);
return;
}
alert(response.value);
}
這個 callback 函數會收到一個 response 物件,它有四個關鍵屬性:
首先檢查 error 是否為 null,就知道這次呼叫有沒有出錯——只要在伺服器端函數中丟出例外即可。範例中我們只是把 value alert 出來;request 屬性則可用來取得更多資訊,例如 response.request.responseText。
Ajax 支援的型別遠多於整數:integers、strings、double、booleans、DateTime、DataSet、DataTable,以及簡單的自訂類別與陣列;其他型別一律透過 ToString() 回傳字串。
回傳 DataSet 的方式與真正的 .NET DataSet 一樣。給定一個回傳 DataSet 的伺服器端函數,可以在客戶端這樣呈現:
<script language="JavaScript">
// 非同步呼叫自訂的 GetDataSet 伺服器端函數
function getDataSet() {
AjaxFunctions.GetDataSet(GetDataSet_callback);
}
function GetDataSet_callback(response) {
var ds = response.value;
if (ds != null && typeof(ds) == "object" && ds.Tables != null) {
var s = new Array();
s[s.length] = "<table border=1>";
for (var i = 0; i < ds.Tables[0].Rows.length; i++) {
s[s.length] = "<tr>";
s[s.length] = "<td>" + ds.Tables[0].Rows[i].FirstName + "</td>";
s[s.length] = "<td>" + ds.Tables[0].Rows[i].Birthday + "</td>";
s[s.length] = "</tr>";
}
s[s.length] = "</table>";
tableDisplay.innerHTML = s.join("");
} else {
alert("Error. [3001] " + response.request.responseText);
}
}
</script>
注意這段程式把資料列的值直接拼進 HTML。若 FirstName 這類欄位含有使用者輸入,就必須先轉義,否則等於把 XSS 寫進了範式裡。
Ajax 也支援自訂類別,但這個類別必須可序列化:
[Serializable()]
public class User {
private int _userId;
private string _firstName;
private string _lastName;
public int userId {
get { return _userId; }
}
public string FirstName {
get { return _firstName; }
}
public string LastName {
get { return _lastName; }
}
public User(int _userId, string _firstName, string _lastName) {
this._userId = _userId;
this._firstName = _firstName;
this._lastName = _lastName;
}
public User() {}
[AjaxMethod()]
public static User GetUser(int userId) {
// 這裡可以換成實際的資料庫查詢
return new User(userId, "Michael", "Schwarz");
}
}
記得先用 Utility.RegisterTypeForAJax(typeof(User)) 註冊這個類別,客戶端才會拿到對應的代理。呼叫之後,回應中的 value 是一個物件,公開與伺服器端同名的屬性(userId、FirstName、LastName)。
由於它是物件的結構化副本而非本體,任何在伺服器端做的驗證都不會自動跟著過來——客戶端拿到的只是資料,改動它並不會影響伺服器狀態,這一點在設計寫入路徑時要特別小心。