Ajax 的價值在於「不刷新頁面就更新局部內容」,而在 ASP.NET 情境下,後端資料要怎麼以 JSON 形式交給 jQuery,有兩條常見路線。本文完整示範這兩種做法,並補充幾個實務上一定會用到的轉換技巧。
在後端引入 System.Web.Services 命名空間,把方法標上 [WebMethod] 並宣告為 static:
[WebMethod]
public static string HelloWorld() { return "123--->456"; }
前台以 jQuery 呼叫時,必須使用 POST、contentType 指定 application/json,url 則是「頁面路徑/方法名」:
// 無參數呼叫
$.ajax({
type: "POST",
contentType: "application/json",
url: "Default2.aspx/HelloWorld",
data: "{}",
dataType: 'json',
success: function(result) { alert(result.d); }
});
// 有參數呼叫
data: "{value1:'心想事成',value2:'萬事如意',value3:'牛牛牛',value4:2009}",
// 回傳集合時,可用 each 走訪
success: function(result) {
$(result.d).each(function() { $('#dictionary').append(this.toString() + " "); });
}
// 回傳複合型別時,直接取屬性
$('#dictionary').append(this['ID'] + " " + this['Value']);
後端對應的方法可以是字串、泛型集合或自 [WebMethod] public static List<int> GetArray(int i) { ... }
[WebMethod]
public static Class1 GetClass() { return new Class1 { ID = "1", Value = "牛年大吉" }; }
先理解 JSON 的兩種基本形式:
物件形式:{ "firstName": "Brett", "lastName":"McLaughlin", "email": "aaaa" }
陣列形式:[{ "firstName": "Brett", ... }, { "firstName": "Jason", ... }]
兩者可以互相嵌套。而微軟的 Ajax 框架預設會把結果包成 { "d": "後台返回的數據" },這就是為什麼取值得寫成 result.d。這個 d 據說來自早期避免 JSON 劫持攻擊的包裝設計。
回傳字串時的實際結構:

回傳 List<> 時:

資料一樣放在 d 屬性裡,只是內容換成了陣列。
ashx 讓你完全掌控輸出的內容與 Content-Type,也更輕量。最直白的寫法是手動組 JSON 字串:
$.ajax({
type: "POST",
url: "Handler.ashx",
dataType: "json",
success: function(data){
alert(data.name); // JSON 形式一(物件)
/* 形式二(陣列)
$(data).each(function(i) { alert(data[i].name); });
*/
}
});
public void ProcessRequest (HttpContext context) {
context.Response.ContentType = "text/plain";
string data = "{\"name\":\"wang\",\"age\":25}";
// string data = "[{\"name\":\"wang\",\"age\":25},{\"name\":\"zhang\",\"age\":22}]";
context.Response.Write(data);
}
手動拼接容易出錯(引號、逗號、轉義),.NET 內建的 JavaScriptSerializer 可以直接把物件序列化:
JavaScriptSerializer jss = new JavaScriptSerializer();
Dictionary<string, string> drow = new Dictionary<string, string>();
drow.Add("name", "Wang");
drow.Add("age", "24");
context.Response.Write(jss.Serialize(drow));
輸出即為 JSON 形式一:

若要輸出形式二(陣列),把多個 Dictionary 裝進 List 再一次序列化即可:
List<Dictionary<string, string>> _list = new List<Dictionary<string, string>>();
_list.Add(drow);
_list.Add(drow1);
context.Response.Write(jss.Serialize(_list));

DT 轉 JSON:逐列建立 Dictionary,key 用欄位名,最後序列化整個 ArrayList。
private string Dtb2Json(DataTable dtb) {
JavaScriptSerializer jss = new JavaScriptSerializer();
ArrayList dic = new ArrayList();
foreach (DataRow row in dtb.Rows) {
Dictionary<string, object> drow = new Dictionary<string, object>();
foreach (DataColumn col in dtb.Columns) { drow.Add(col.ColumnName, row[col.ColumnName]); }
dic.Add(drow);
}
return jss.Serialize(dic);
}
JSON 轉 DT:反序列化成 ArrayList,用第一列的 key 建立欄位,其餘列逐筆填入。
private DataTable Json2Dtb(string json) {
JavaScriptSerializer jss = new JavaScriptSerializer();
ArrayList dic = jss.Deserialize<ArrayList>(json);
DataTable dtb = new DataTable();
if (dic.Count > 0) {
foreach (Dictionary<string, object> drow in dic) {
if (dtb.Columns.Count == 0) {
foreach (string key in drow.Keys) { dtb.Columns.Add(key, drow[key].GetType()); }
}
DataRow row = dtb.NewRow();
foreach (string key in drow.Keys) { row[key] = drow[key]; }
dtb.Rows.Add(row);
}
}
return dtb;
}
把回傳的 JSON 直接渲染成表格,前台只需要動態組 DOM:
success: function(data){
var table = $("<table border='1'></table>");
for (var i = 0; i < data.length; i++) {
var row = $("<tr></tr>");
for (key in o1) { var td = $("<td></td>"); td.text(o1[key].toString()); td.appendTo(row); }
row.appendTo(table);
}
table.appendTo($("#back"));
}
一、取陣列中的屬性時,data[i].name 與 data[i]["name"] 等價。
二、要瀏覽物件的「所有屬性」,必須用 for...in 搭配變數取值,不能寫成 data[i].key——那樣 key 會被當成字面屬性名而非變數:
success: function(data){
$(data).each(function(i) {
for(key in this) alert(data[i][key]); // 正確
});
}
ajaxStart 與 ajaxStop 是全域事件,很適合統一控制一個 loading 指示器:
$('#loading').ajaxStart(function() { $(this).show(); })
.ajaxStop(function() { $(this).hide(); });
總結:追求開發速度與與既有 WebService 整合時用方法一;追求輕量、可控與更好的效能表現時,方法二(ashx + JavaScriptSerializer)是更值得推薦的選擇。