Ajax 是 Asynchronous JavaScript + XML 的縮寫,核心概念是透過 XMLHttpRequest 與伺服器進行非同步溝通,讓頁面不必整頁刷新就能更新內容,進而打造流暢的使用者體驗。
在 jQuery 普及之前,.NET 平台有一個相當受歡迎的方案:Ajax.NET(Ajax.dll)。它把伺服器端的方法自動「暴露」成前端可直接呼叫的函式,寫起來非常直覺。以下用一個完整範例走過一次設定流程。
把 Ajax.dll 複製到應用程式的 bin 目錄,然後在專案的「加入參考」中指向它。
在 httpHandlers 區段註冊 Ajax 的處理器,讓所有 ajax/*.ashx 的請求都能導向她:
<httpHandlers>
<add verb="POST,GET" path="ajax/*.ashx"
type="Ajax.PageHandlerFactory, Ajax" />
</httpHandlers>
假設應用程式名稱為 Document,在 Pages\AjaxTest 下新增 AjaxMethod.cs:
using Ajax;
namespace Document.Pages.AjaxTest
{
public class AjaxMethod
{
// 宣告 this method 需要讀取 Session
[Ajax.AjaxMethod(Ajax.HttpSessionStateRequirement.Read)]
public static string GetNIVNumber(string str)
{
return str;
}
}
}
關鍵在於 [Ajax.AjaxMethod] 這個 attribute:加上它,方法就會被註冊成前端可呼叫的函式;不加,則維持一般的伺服器端方法。
在 Pages\AjaxTest 下新增 AjaxForm.aspx:
<html>
<head>
<title>AjaxForm</title>
<script language="javascript">
function testAjax() {
var first = document.getElementById("txtfirst");
AjaxMethod.GetNIVNumber(first.value, callback_GetNIVNumber);
}
function callback_GetNIVNumber(res) {
var obj = document.getElementById("txtsecond");
obj.value = res.value;
}
</script>
</head>
<body>
<form id="Form1" method="post" runat="server">
<asp:TextBox id="txtfirst" runat="server"></asp:TextBox>
<input type="button" value="Button" onclick="testAjax();" />
<asp:TextBox id="txtsecond" runat="server"></asp:TextBox>
</form>
</body>
</html>
最後,別忘了在後端程式碼裡註冊這個類別,Ajax.NET 才知道要去哪裡找方法:
protected System.Web.UI.WebControls.TextBox txtfirst;
protected System.Web.UI.WebControls.TextBox txtsecond;
private void Page_Load(object sender, System.EventArgs e)
{
// 參數為 AjaxMethod.cs 所在的完整命名空間
Ajax.Utility.RegisterTypeForAjax(typeof(Document.Pages.AjaxTest.AjaxMethod));
}
完成以上設定後即可運作:在第一個文字框輸入內容,按下按鈕,字串會透過非同步請求送到伺服器,再由回呼函式寫入第二個文字框。整個過程頁面沒有閃動、沒有重新載入。
這只是最基礎的骨架。你可以在 GetNIVNumber 裡改成查詢資料庫、呼叫服務,或回傳更複雜的結構,再在前端依需要更新畫面。
補充說明:Ajax.NET 屬於較早期的解決方案,在今日的專案中,建議改用 jQuery $.ajax()、fetch 搭配 Web API 或 MVC 控制器,這是更容易維護、社群支援也更完整的做法。本範例仍有助於理解「前端直接呼叫伺服器方法」這個核心概念。