想用 JavaScript 直接呼叫 WebService,ASP.NET AJAX 是最省事的選擇。實作上只要三個步驟:建立 .asmx 服務、在 ScriptManager 中註冊服務參考、然後在頁面腳本裡呼叫。真正容易卡住的地方,是服務端少了一個屬性宣告。
先加入一個 WebService(webservice.asmx),寫好要暴露的方法:
using System.Web.Script.Services;
[WebService(Namespace = "https://tempuri.org/")]
[WebServiceBinding(ConformsTo = WsiProfiles.BasicProfile1_1)]
[ScriptService]
public class WebService : System.Web.Services.WebService
{
[WebMethod]
public string HelloWorld()
{
return "Hello World";
}
}
關鍵就在 [ScriptService] 這個屬性,以及 using Microsoft.Web.Script.Services; 這行命名空間引用。少了它,服務只是一般的 SOAP 端點,客戶端不會產生對應的 JavaScript 代理。
<asp:ScriptManager runat="server" ID="scriptManager">
<Services>
<asp:ServiceReference Path="webservice.asmx" />
</Services>
</asp:ScriptManager>
注意 Services 區段要正確閉合,原範例中結尾標籤漏了斜線,會直接導致解析錯誤。註冊之後,ASP.NET AJAX 會自動產生一個與服務同名的 JavaScript 代理物件。
<button type="button" onclick="getHello()">hello world</button>
<script type="text/javascript">
function getHello()
{
WebService.HelloWorld(onCallComplete);
}
function onCallComplete(result)
{
alert(result);
}
</script>
呼叫形式為「服務名稱.方法名稱(參數..., 成功回呼)」。回呼函式收到的參數就是 WebMethod 的回傳值。若需要更細緻的控制,也可以傳入失敗回呼與逾時設定。
按下按鈕後如果瀏覽器抱怨「webservice 未定義」,通常不是腳本寫錯,而是代理根本沒產生。可以依序檢查:
本文的問題就是因為當初直接照抄範例,漏看了官方範例在類別前方加的那行屬性宣告。補上之後即可正常運作。