Ajax 是什麼不必我多說,不熟的讀者搜尋一下會比我講得專業。這篇的目的不是深入探討,而是用一個最簡單的例子把「基本呼叫要做哪些事」交代清楚。環境是 VS2005。
加入 AjaxPro.2.dll 的參考,並在 web.config 的 <system.web> 區段註冊 HTTP Handler:
<httpHandlers>
<add verb="POST,GET" path="ajaxpro/*.ashx"
type="AjaxPro.AjaxHandlerFactory,AjaxPro.2"/>
</httpHandlers>
這一步是整個框架的入口。少了它,前端呼叫永遠會得到 404。
新增 Default.aspx,在 code-behind 的 Page_Load 註冊:
protected void Page_Load(object sender, EventArgs e)
{
AjaxPro.Utility.RegisterTypeForAJax(typeof(_Default));
}
[AjaxPro.AjaxMethod]
public string SetTb(string name)
{
return name;
}
[AjaxPro.AjaxMethod] 一定要加,否則前端看不到這個方法。
<%@ Page Language="C#" AutoEventWireup="true" CodeFile="Default.aspx.cs" Inherits="_Default" %>
<html xmlns="https://www.w3.org/1999/xhtml">
<head runat="server">
<title>無標題頁</title>
<script language="Javascript" type="text/javascript">
// <![CDATA[
function comit_onclick() {
var name = document.getElementById("tb1").value;
_Default.SetTb(name, callback);
}
function callback(res) {
document.getElementById("tb").value = res.value;
}
// ]]>
</script>
</head>
<body>
<form id="form1" runat="server">
<div>
<asp:TextBox ID="tb1" runat="server"></asp:TextBox><br />
<input id="comit" type="button" value="Ok" onclick="comit_onclick()" /><br />
<asp:TextBox ID="tb" runat="server"></asp:TextBox>
</div>
</form>
</body>
</html>
關鍵那一行是 _Default.SetTb(name, callback):它會去呼叫 code-behind 裡的 SetTb 方法,最後一個參數固定是處理回應的 JS 函式。如果伺服器方法不需要參數,就寫成 _Default.SetTb(callback)。
另外三點實務提醒:伺服器方法回傳的物件會被包成一個帶 value 屬性的包裝,所以取值得寫 res.value;AjaxPro 的註冊必須在每次 Request 都執行,放在 Page_Load 是對的;最後,AjaxPro 這個專案早已停止維護,它只適合理解原理或維護舊系統,新專案請改用 ASP.NET Web API、SignalR 或框架原生的 WebMethod + PageMethods。