要在 jQuery 中直接呼叫 ASP.NET 的 server-side 方法,做法是把 WebMethod 掛在 page 上,然後用 JSON 格式溝通。這個範例示範最精簡的版本。
<html xmlns="https://www.w3.org/1999/xhtml">
<head runat="server">
<title></title>
<script src="script/jquery-1.3.2.js" type="text/jscript"></script>
<script type="text/jscript">
function show(num) {
var params = '{str:"' + num + '"}';
$.ajax({
type: "POST",
url: "default.aspx/aa",
data: params,
dataType: "text",
contentType: "application/json; charset=utf-8",
beforeSend: function(XMLHttpRequest) {
$('#show').text("正在查詢");
},
success: function(msg) {
$('#show').text(eval("(" + msg + ")").d);
},
error: function(xhr, msg, e) { alert(msg); }
});
}
</script>
</head>
<body>
<form id="form1" runat="server">
<div id="click" onclick="show('執行成功');">點擊我!</div>
<div id="show"></div>
</form>
</body>
</html>
[System.Web.Services.WebMethod()]
public static string aa(string str)
{
return str;
}
方法必須是 static。PageMethods 由框架直接呼叫,沒有頁面實例,因此非靜態方法會失敗。
URL 要寫成「頁面/方法名」。default.aspx/aa 這種形式對應到 aspx 上的 WebMethod。
type 必須是 POST。GET 無法呼叫 PageMethods。
contentType 必須是 JSON。這是告訴伺服器「我送的是 JSON」,缺了它,方法會收不到參數。
另外,参数的 key 必須和方法簽章中的參數名稱完全一致。範例中方法參數叫 str,前端就必須送 {str: "..."},大小寫也要對得上。
範例用 eval("(" + msg + ")") 解析回應,這是舊寫法。現在請改用:
success: function(msg) {
$('#show').text(msg.d); // dataType: "json" 時可直接取值
}
把 dataType 設為 "json",jQuery 就會幫你解析好,回呼收到的 msg 已經是物件,msg.d 直接就是回傳值(.d 是 ASP.NET 為了防範 JSON 劫持而加的包裝屬性)。eval 會執行回應字串中的任意程式碼,能避開就該避開。
還有個更根本的問題:把字串手工拼成 JSON('{str:"' + num + '"}')很危險,一旦 num 含有引號就會產生格式錯誤的 JSON。請改用物件字面量:
data: { str: num }
jQuery 會自行序列化並正確跳脫,不必也不該自己拼字串。
範例中 beforeSend 用來顯示「正在查詢」,這是相當實用的模式。使用者點擊後立刻看到回饋,比空白等待友善得多。實務上通常還會在 error 與 complete 中把提示清掉,並在等待期間停用按鈕避免重複送出。