這幾天手上的任務告一段落,就抽空把 WebService 這塊補了一下,實際上手比想像中簡單。
用 VS2008 開一個 ASP.NET 網站,然後在專案上按右鍵 →「新增項目」→「Web 服務」。

接著會產生 WebService.cs 與 WebService.asmx 兩個檔案。
關鍵是加上 [ScriptService] 這行,預設是註解掉的,不取消註解前端就取不到代理物件。
using System;
using System.Web.Services;
using System.Web.Script.Services;
/// <summary>
/// WebService 的摘要說明
/// </summary>
[WebService(Namespace = "https://tempuri.org/")]
[WebServiceBinding(ConformsTo = WsiProfiles.BasicProfile1_1)]
[ScriptService] // 若要允許從腳本呼叫此 Web 服務,必須加上這行
public class WebService : System.Web.Services.WebService
{
public WebService() { }
[WebMethod]
public string HelloWorld()
{
return "Hello World";
}
[WebMethod]
public int GetSum(int a, int b)
{
return a + b;
}
}
<%@ Page Language="C#" AutoEventWireup="true" CodeFile="Default.aspx.cs" Inherits="_Default" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"https://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="https://www.w3.org/1999/xhtml">
<head runat="server">
<title></title>
</head>
<script language="javascript">
function Method(obj) {
document.getElementById("txtSum").value = obj;
}
function Hello() {
WebService.HelloWorld(backMethod);
}
function getSum() {
var a = document.getElementById("txtA").value;
var b = document.getElementById("txtB").value;
try {
WebService.GetSum(a, b, Method);
} catch (err) {
alert(err.description);
}
}
</script>
<body>
<form id="form1" runat="server">
<div>
<asp:ScriptManager ID="ScriptManager1" runat="server">
<Services>
<asp:ServiceReference InlineScript="True" Path="WebService.asmx" />
</Services>
</asp:ScriptManager>
<input type="button" id="btHello" value="Hello" onclick="Hello();" /><br />
<input type="text" id="txtA" value="" /> +
<input type="text" id="txtB" value="" /> =
<input type="text" id="txtSum" value="" />
<input type="button" id="btSum" value="求和" onclick="getSum();" /><br />
</div>
</form>
</body>
</html>
ScriptManager 加上 ServiceReference 之後,ASP.NET AJAX 會自動產生一層 JavaScript 代理,前端就能用「服務名稱.方法名稱(參數, 回呼函式)」的形式直接呼叫,底層的 XML 序列化與 HTTP 往返都被封裝掉了。最後一個參數是成功後的回呼,若要處理失敗,可以再傳入第四個參數作為錯誤回呼。
WebService 的傳回值也不限於基本型別,回傳 DataSet 這類結構同樣可以,只是前端拿到的會是 JSON 化的物件,取值方式要相應調整。
如果有不錯的 WebService 學習資源,歡迎分享出來一起交流。