DIV CSS 佈局教程網

前端呼叫後端方法的四種方式:PageMethods、WebMethod、內嵌標記與 AJAX
編輯:關於JavaScript     

專案裡到處都需要前后端資料往來。常見手段各有取捨:AutoPostBack 有即時性但會刷新整頁;Button 提交表單能送出資料卻不具即時性;AJAX 能做到非同步、局部刷新,但當「下一步驟必須等資料回來才能繼續」時,反而需要同步或回呼串接。以下整理幾種 ASP.NET WebForm 情境下的做法。

方法一:ScriptManager + PageMethods

後端

// 必須標上 WebMethod
[System.Web.Services.WebMethod]
// 供前端呼叫的方法必須是 public 且 static
public static string Say(string name)
{
    return "Hello:" + name;
}

前端

<script type="text/javascript">
function btnClick() {
    PageMethods.Say("you", funReady, funError);
}

// 成功回呼:result 就是後端回傳的資料
function funReady(result) { alert(result); }

// 失敗回呼:err 是錯誤資訊
function funError(err) { alert("Error:" + err._message); }
</script>

<asp:ScriptManager ID="ScriptManager1" runat="server" EnablePageMethods="true" />
<input type="button" onclick="btnClick()" value="test" />

關鍵是 ScriptManager 必須設 EnablePageMethods="true",否則前端拿不到 PageMethods 這個物件。

方法二:伺服端標記直接內嵌

後端

protected string Say(string strCC)
{
    return "你好!" + strCC;
}

前端

<script type="text/javascript">
function Show() {
    var v = "中國";
    var s = '<%=Say(" " + v + " ") %>';   // 由伺服器在輸出時替換
    alert(s);
}
</script>
<input type="button" onclick="Show()" value="提交" />

這個做法的限制很明顯:<%= %> 是輸出時展開的,前端的值根本還不存在,因此無法把前端的資料傳到後端,只能「後端算好、前端顯示」。

方法三:ScriptManager + WebService 參考

後端(WebSerCustomer.asmx)

[System.Web.Services.WebMethod]
public static string Say(string name)
{
    return "Hello:" + name;
}

前端

<script type="text/javascript">
function btnClick() {
    // 依序為:參數、成功回呼(失敗回呼可選)
    WebSerCustomer.Say("you", function (ress) {
        alert(ress);
    });
}
</script>

<asp:ScriptManager ID="ScriptManager1" runat="server">
  <Services>
    <asp:ServiceReference Path="~/WebSerCustomer.asmx" />
  </Services>
</asp:ScriptManager>

<input type="button" onclick="btnClick()" value="test" />

方法四:一般 HTTP 端點 + AJAX(今天的主流)

// 後端 Web API / handler,回傳 JSON
[HttpPost]
public IActionResult SetResolution(ResolutionModel model)
{
    // … 處理 …
    return Json(new { success = true, message = "已儲存" });
}
fetch('/api/resolution', {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify(model)
})
.then(r => r.json())
.then(res => { if (res.success) showToast(res.message); })
.catch(err => console.error(err));

綜合比較

  • 方法一、三:靠 [WebMethod] 宣告可被前端呼叫,且方法必須 public static。正因為是 static,只能存取靜態成員,需要讀寫实例狀態(例如 Session、其他欄位)時就卡住了。
  • 方法二:後端方法沒有任何限制,但 <%= %> 是唯讀展開,前端傳值給後端這件事根本做不到。適合「後端處理後回傳給前端顯示」,不適合「把資料交給後端處理」。
  • 方法四:無框架綁定、可用任何後端技術、能帶 CSRF token 與自訂表頭,是目前的標準答案。

另外提醒:這幾種方法都是非同步的,程式不會停在呼叫那一行等回應。若真的需要「依序執行」,請用 async/await 把流程寫成同步的樣子,而不是嘗試讓 AJAX 同步(async:false 已於現代瀏覽器被揚棄,會凍結整個 UI)。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved