Web Service(.asmx)是早期很常見的服務端發布方式。要讓前端能透過 Ajax 呼叫它,關鍵是在類別上加上 ScriptService 屬性。
[System.Web.Script.Services.ScriptService]
public class WebService : System.Web.Services.WebService
{
public WebService () {
//如果使用設計的組件,請取消註釋以下行
//InitializeComponent();
}
[WebMethod]
public string GetWhether(string cityId)
{
Random r = new Random();
int degree = r.Next(100);
string wInfo = string.Format(
"Today {0}'s temperature is {1} degrees", cityId, degree);
return wInfo;
}
}
[ScriptService] 這個屬性不能省。少了它,ASP.NET 就不會為這個 WebService 產生 JavaScript 代理,前端請求會直接被拒絕。這是最常見的入門陷阱。
<html xmlns="https://www.w3.org/1999/xhtml">
<head runat="server">
<title></title>
<script type="text/javascript" language="javascript" src="js/jquery-1.3.2.js"></script>
</head>
<body>
<form id="form1" runat="server">
<div>
<input type="text" name="Text1" id="Text1"/><br />
<input type="text" name="Text2" id="Text2"/><br />
<input type="button" id="btn1" onclick="BtnCity_Click()"
style="width:55px; height:20px;" />
</div>
<div id="dd">sd</div>
<div>
<script type="text/javascript" language="javascript">
function BtnCity_Click() {
var city = $("#Text1").val();
$.ajax({
url: "WebService.asmx/GetWhether",
data: { cityId: city },
type: "post",
success: function(data, status) {
$("#dd").html("<h1>天氣情況:" + data.childNodes[1].text + "</h1>");
}
});
}
</script>
</div>
</form>
</body>
</html>
URL 的寫法。WebService.asmx/GetWhether 這種「檔名/方法名」的形式是 ASP.NET WebService 特有的路由方式,跟一般 MVC 路由不同,寫錯會得到 404。
回應是 XML。WebMethod 預設以 SOAP/XML 回應,所以範例才用 data.childNodes[1].text 這種節點走訪取值。這種寫法很依賴節點順序,一旦回應結構改變就會出錯,比較穩健的方式是搭配 $(data).find("string").text() 明確定位。
方法名稱拼字。範例中的 GetWhether 應為 GetWeather,這裡保留原樣以便對照;自己實作時請留意命名一致性,否則 URL 對不上就是 404。
最後要說明的是,.asmx Web Service 已屬於舊技術,微軟官方建議改用 WCF 或 ASP.NET Web API。新專案中,Web API 搭配 dataType: "json" 會比走 SOAP/XML 單純許多,也不必處理 childNodes 索引這類脆弱結構。