ASP.NET 的 UpdatePanel 把「伺服器端丟例外」這件事藏得很好,好到你在用戶端什麼也看不到。要把錯誤訊息真正接出來,大致是四個步驟。
訂閱 ScriptManager 的 AsyncPostBackError 事件,並在事件處理方法中把例外重新拋出。視情況可能需要拋 e.Exception,或改拋它的 InnerException(當外層只是包裝用的 HttpException 時,真正的訊息在 InnerException 裡)。
protected void ScriptManager1_AsyncPostBackError(object sender, AsyncPostBackErrorEventArgs e)
{
// 只拋出真正有意義的那層例外
Exception ex = (e.Exception.InnerException != null) ? e.Exception.InnerException : e.Exception;
throw ex;
}
Sys.WebForms.PageRequestManager.getInstance().add_endRequest(EndRequestHandler);
錯誤資訊基本都在第二個參數 args 裡面,用 args.get_error() 取得錯誤物件,處理完記得呼叫 args.set_errorHandled(true),否則瀏覽器還是會跳出預設的錯誤視窗。
function EndRequestHandler(sender, args) {
if (args.get_error() != undefined) {
alert(args.get_error().message.replace(/.*Exception:/, ''));
args.set_errorHandled(true);
}
}
網路上找不到現成文檔,於是自己寫了段程式把它逐一列舉出來。方法很直接:用 for-in 跑一層,遇到物件再往下鑽一層,把屬性名稱收集起來丟進 textarea 顯示。
Sys.WebForms.PageRequestManager.getInstance().add_endRequest(EndRequestHandler);
function EndRequestHandler(sender, args) {
if (args.get_error() != undefined) {
args.set_errorHandled(true);
var members = 'The \'args\' members are:\n\n';
for (var i in args) {
members += '\t' + i + '\n';
var ai = args[i];
if (typeof ai == "string") continue;
for (var t in ai) {
members += '\t\t' + t + '\n';
var ait = ai[t];
if (typeof ait == "string") continue;
for (var m in ait) {
members += '\t\t\t' + m + '\n';
}
}
}
document.write("<textarea style='width:1000px; height:600px;'>" + members + "</textarea>");
}
}
把 document.write 換成實際的 UI 呈現會更實用一些——例如寫進頁面上預留的 div,或改用 Sys.Debug.trace 輸出。另外,直接把 get_error().message 丟給使用者看通常不是好主意:例外訊息往往包含堆疊、連線字串片段或資料表名稱等不該外洩的資訊。比較穩妥的做法是伺服器端先分類處理,對外只回傳友善的提示,詳細內容寫進 log。
原範例中的 eval("args." + i) 也可以直接寫成 args[i],效果相同且安全得多,沒有理由用 eval。