前端要拿後端的資料,方法不止一種。本文整理三種在 ASP.NET 環境下常見的實作路徑,從最簡單的行內標記,到結構完整的 $.ajax(),再到需要額外 DLL 的 AjaxPro,並比較各自的適用時機與限制。
最直白的做法,在伺服器產生頁面的階段就把後端函式的回傳值嵌進 JavaScript 變數裡。
前台 JS:
<script type="text/javascript"> var methodStr = "<%=BehindMethod() %>"; alert(methodStr); </script>
後端方法:
public static string BehindMethod()
{
return "這是一個後台的方法";
}
適用時機:資料在頁面載入時就已確定、不需要互動更新的情況。
限制:值在伺服器渲染那一刻就固定了,使用者後續操作無法取得新資料;而且方法必須是 public static,否則編譯會報錯。
這是真正意義上的非同步溝通。前台在按鈕點擊時才發請求,收到回應後再更新畫面。
前台 JS:
<script type="text/javascript" src="js/jquery-1.4.3.min.js"></script>
<script type="text/javascript">
var params = '{ext:"p9hp"}'; //參數,注意參數名要和後台方法參數名一致
$(function(){
$("#btnOk").click(function(){
$.ajax({
type: "POST", //請求方式
url: "AjaxDemo.aspx/GetImg", //請求路徑:頁面/方法名字
data: params, //參數
dataType: "text",
contentType: "application/json; charset=utf-8",
beforeSend: function(XMLHttpRequest){
$("#tips").text("開始調用後頭方法獲取圖片路徑,請等待");
$("#imgFood").attr("src","image/loading.gif");
},
success: function(msg){ //成功
$("#imgFood").attr("src", eval("(" + msg + ")").d);
$("#tips").text("調用方法結束");
},
error: function(obj, msg, e){ //異常
alert("OH,NO");
}
});
});
});
</script>
頁面 HTML:
<body>
<form id="form1" runat="server">
<div>
<label id="tips"></label>
<img id="imgFood" />
<input value="點擊我,給你看一張圖片" type="button" width="35px" id="btnOk" />
</div>
</form>
</body>
後端方法(需標上 WebMethod,且宣告為 static):
[System.Web.Services.WebMethod]
public static string GetImg(string ext)
{
System.Threading.Thread.Sleep(5000); //為了有點等待的效果,延遲5秒
StringComparer sc = StringComparer.OrdinalIgnoreCase;
string[] extArr = new string[] { "php", "asp", "aspx", "txt", "bmp" };
bool f = extArr.Any(s => sc.Equals(s, ext)); //判斷傳入的後綴名是否存在
if (f)
{
return "image/54222860.jpg";
}
return "image/star1.jpg";
}
這個範例有三個值得學的細節:beforeSend 裡先顯示 loading 動畫與提示文字,讓等待不那麼焦慮;contentType 明確宣告 JSON,後端才會正確序列化;Thread.Sleep(5000) 則是刻意製造延遲,用來觀察 loading 狀態是否真的生效。
要注意的是,範例中 eval("(" + msg + ")") 這種解析方式在今天已經不建議使用,改用 JSON.parse(msg) 更安全,也能避免執行來路不明的字串。實務上更乾淨的做法是把 dataType 設為 "json",讓 jQuery 自動完成反序列化。
AjaxPro 是一個把伺服器方法自動「代理」成前端可呼叫函式的框架,呼叫語法幾乎和呼叫本地函式一樣,因此寫起來最省力。
第一步:下載 AjaxPro.dll(或 AjaxPro.2.dll),加入專案參考。
第二步:修改 web.config,註冊 HTTP Handler:
<system.web> <httpHandlers> <!--注冊ajaxPro.2--> <add verb="*" path="*.ashx" type="AjaxPro.AjaxHandlerFactory,AjaxPro.2"/> </httpHandlers> </system.web>
第三步:在 Page_Load 中做執行期註冊:
protected void Page_Load(object sender, EventArgs e)
{
AjaxPro.Utility.RegisterTypeForAjax(typeof(AjaxDemo)); //注冊
}
第四步:建立伺服器方法並加上標記:
[AjaxPro.AjaxMethod]
public string GetImgByAjaxPro()
{
return "image/54222860.jpg";
}
第五步:前台直接呼叫,命名空間在前、類別在中、方法在後:
function GetMethodByAjaxPro() {
var a = JustTest.AjaxDemo.GetImgByAjaxPro(); //JustTest是當前名字空間,AjaxDemo表示後台類
document.getElementById("imgAjaxPro").src = a.value;
}
如果資料在頁面產生時就固定,用行內標記最省事;需要互動更新就用 $.ajax(),這也是目前最通用、資料流最可控的選擇;AjaxPro 雖然語法甜,但已多年未維護,且需要改動伺服器設定,新專案不建議採用。無論哪一種,記得把資料庫連線與業務邏輯留在後端,前端只負責請求與呈現。