在不引入任何 JavaScript 框架的前提下,只要靠瀏覽器原生的 XMLHttpRequest,就能非同步呼叫 ASP.NET 的 WebService。以下把整個流程拆成前端頁面與後端服務兩部分。
建立物件的環節需要分版本處理:Firefox、Opera 8.0+、Safari 等直接 new XMLHttpRequest();舊版 IE 則要退回到 ActiveXObject,並依序嘗試 Msxml2.XMLHTTP 與 Microsoft.XMLHTTP,全都失敗就提示使用者瀏覽器不支援。
function ajaxCall() {
var xmlHttp;
try {
// Firefox、Opera 8.0+、Safari
xmlHttp = new XMLHttpRequest();
} catch (e) {
try {
// Internet Explorer 新版
xmlHttp = new ActiveXObject("Msxml2.XMLHTTP");
} catch (e) {
try {
// Internet Explorer 舊版
xmlHttp = new ActiveXObject("Microsoft.XMLHTTP");
} catch (e) {
alert("瀏覽器不支援 Ajax!");
return false;
}
}
}
// 綁定資料處理函式
xmlHttp.onreadystatechange = function () {
if (xmlHttp.readyState === 4) {
if (xmlHttp.status === 200) {
document.getElementById('lbText').innerHTML = xmlHttp.responseText;
} else {
alert('請求出錯。');
}
}
};
// 第三個參數 true 代表非同步
xmlHttp.open("POST", "https://localhost:1576/WebService1.asmx/HelloWorld", true);
// POST 請求務必設定這個標頭,否則 status 會異常
xmlHttp.setRequestHeader("Content-Type", "application/x-www-form-urlencoded;");
// strName 是 HelloWorld 方法的參數名稱
xmlHttp.send("strName=gg");
}
頁面結構很簡單,一個觸發連結加上一個用來顯示結果的標籤:
<a href="javascript:void(0)" onclick="ajaxCall()">點擊此處</a> <asp:Label ID="lbText" runat="server"></asp:Label>
重點有兩個:類別上要有 ScriptService 屬性,方法上要標上 ScriptMethod,這樣用戶端腳本才有辦法直接呼叫。
[WebService(Namespace = "https://tempuri.org/")]
[WebServiceBinding(ConformsTo = WsiProfiles.BasicProfile1_1)]
[System.ComponentModel.ToolboxItem(false)]
// 若要允許使用 ASP.NET Ajax 從腳本中呼叫此 Web 服務,請取消下一行的註解
[System.Web.Script.Services.ScriptService]
public class WebService1 : System.Web.Services.WebService
{
[WebMethod, ScriptMethod]
public string HelloWorld(string strName)
{
return strName + " Hello World";
}
}
最常見的兩個坑:一是忘了設定 Content-Type 請求標頭,導致 status 拿不到預期的 200;二是 send() 送出的字串必須是「參數名=值」的形式,參數名稱要與方法簽章完全一致,否則伺服器端收到的會是 null。另外,若把服務與頁面放在不同網域,還會遇到同源策略的阻擋,那就得回到 CORS 或 JSONP 的路子上處理。