在 ASP.NET AJAX 中,若頁面套用母版頁,有時會需要從母版頁發送非同步請求。此時可以使用 Sys.Net.WebRequest,建立一個輕量級的 Ajax 請求流程。
首先在頁面中放入 ScriptManager,並設定 EnablePageMethods 為 true,以便使用 Ajax 相關腳本。接著在母版頁中撰寫 JavaScript 函式,建立 Sys.Net.WebRequest 的執行個體。
建立後,設定請求網址、請求主體與請求方式。例如,可將網址設為 CheckState 資料夾下的某個 aspx 頁面,請求主體放入參數,請求方式設為 POST。接著註冊 completed 事件,最後呼叫 invoke 執行請求。
當請求完成後,會進入 completed 事件處理函式。此函式通常會接收兩個參數:發出請求的執行器,以及事件引數。可先判斷執行器是否 responseAvailable,再檢查狀態碼是否為 200。若正常,就透過 get_responseData 取得回傳內容。
在這個例子中,請求頁面可用來執行 Ping 功能。後端收到 ip 參數後,使用 NetworkInformation.Ping 判斷網路是否可達,再將結果寫回頁面。前端收到 0 或 1 後,即可顯示對應狀態。
add_completed 註冊的事件處理函式,必須接受兩個參數。第一個是對發出網路請求的執行器的參考,透過它可以檢查狀態與取得回應資料。第二個是事件引數,由引發完成事件的執行器設定。
使用這種方式時,請求頁面最好不要包含過多 HTML,只需在 Page_Load 中處理邏輯並輸出結果。這樣可減少不必要的傳輸,也讓前端更容易解析回應。
整體來說,Sys.Net.WebRequest 提供了一個在母版頁中發送 Ajax 請求的可行方案。只要掌握請求設定、完成事件與回應處理,就能在共用版面中實作出非同步資料取得的功能。