EasyUI ComboBox 要求資料來源回傳特定 JSON 格式(id/text 欄位),而 ASP.NET WebForm 預設 [WebMethod] 回傳會包裝在 d 屬性且需 contentType: application/json,導致無法直接整合。本文示範使用 ASHX 一般處理常式 繞過 WebForm 頁面生命週期,乾淨輸出 JSON,完美解決整合問題。
<input class="easyui-combobox"
name="language"
data-options="
url: '/Handler/ComboData.ashx',
valueField: 'id',
textField: 'text',
panelHeight: 'auto'
">
伺服器需回傳陣列:[{"id":1,"text":"選項一"},{"id":2,"text":"選項二"}]
$.ajax({
type: "POST",
url: "Page.aspx/GetData",
data: "{param: 'value'}",
contentType: "application/json; charset=utf-8",
dataType: "json",
success: function(data) {
// data.d 才是真實資料,且 EasyUI 無法指定 contentType
}
});
contentType,但 EasyUI data-options 無此參數。{"d": [...]},非 EasyUI 直認格式。// ComboData.ashx.cs
using System;
using System.Web;
using System.Web.Script.Serialization;
using System.Collections.Generic;
public class ComboData : IHttpHandler
{
public void ProcessRequest(HttpContext context)
{
context.Response.ContentType = "application/json; charset=utf-8";
// 模擬資料來源(實務從 DB/快取取得)
var list = new List
<input class="easyui-combobox"
data-options="url: '/ComboData.ashx', valueField: 'id', textField: 'text'">
| 特性 | .ashx 處理常式 | .aspx 網頁表單 |
|---|---|---|
| 生命週期 | 極輕量,無頁面事件 | 完整頁面生命週期 |
| 輸出內容 | 完全控制,純 JSON/圖片/二進位 | 預設輸出 HTML |
| 效能 | 極快,無 ViewState/Control Tree | 較重 |
| 適用場景 | AJAX API、檔案下載、圖片產生、RSS | 完整頁面呈現 |
public void ProcessRequest(HttpContext context)
{
context.Response.ContentType = "application/json";
string q = context.Request["q"]; // EasyUI 會自動傳送 q 參數
int page = int.Parse(context.Request["page"] ?? "1");
int rows = int.Parse(context.Request["rows"] ?? "20");
// 依 q 過濾、分頁查詢 DB...
var data = GetPagedData(q, page, rows);
var total = GetTotalCount(q);
// EasyUI DataGrid/ComboBox 分頁格式
var result = new { total, rows = data };
context.Response.Write(new JavaScriptSerializer().Serialize(result));
}
ASP.NET WebForm 整合 EasyUI 等前端框架時,棄用 WebMethod 改用 ASHX 是最乾淨、效能最佳的做法。ASHX 繞過繁重頁面生命週期,直接輸出標準 JSON,完美符合 EasyUI、jQuery UI、Select2 等元件的資料源需求。