萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> ASP.NET 程式設計

ASP.NET 搭配 EasyUI 回傳 JSON 資料實作:以 ComboBox 為例

前言

EasyUI ComboBox 要求資料來源回傳特定 JSON 格式(id/text 欄位),而 ASP.NET WebForm 預設 [WebMethod] 回傳會包裝在 d 屬性且需 contentType: application/json,導致無法直接整合。本文示範使用 ASHX 一般處理常式 繞過 WebForm 頁面生命週期,乾淨輸出 JSON,完美解決整合問題。

一、EasyUI ComboBox 資料格式需求

<input class="easyui-combobox"
       name="language"
       data-options="
           url: '/Handler/ComboData.ashx',
           valueField: 'id',
           textField: 'text',
           panelHeight: 'auto'
       ">

伺服器需回傳陣列:[{"id":1,"text":"選項一"},{"id":2,"text":"選項二"}]

二、WebMethod 直接回傳的問題

$.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 直認格式。
  • .aspx 頁面會輸出完整 HTML 生命週期內容,干擾純 JSON 輸出。

三、ASHX 處理常式完美解決方案

建立 ComboData.ashx

// 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
        {
            new { id = 1, text = "選項一" },
            new { id = 2, text = "選項二" },
            new { id = 3, text = "選項三" }
        };

        var json = new JavaScriptSerializer().Serialize(list);
        context.Response.Write(json);
    }

    public bool IsReusable => false;
}


前端指向 ASHX

<input class="easyui-combobox"
       data-options="url: '/ComboData.ashx', valueField: 'id', textField: 'text'">

四、ASHX vs ASPX 差異比較

特性.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 等元件的資料源需求。

copyright © 萬盛學電腦網 all rights reserved