萬盛學電腦網

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

ASP.NET 使用 AJAX 局部更新 GridView 資料繫結完整範例

需求場景

傳統 ASP.NET WebForms 中,GridView 資料更新通常需要整頁回傳。本文示範如何使用原生 XMLHttpRequest 實現局部刷新,僅更新 GridView 區塊,提升使用者體驗並減少頻寬消耗。

完整單一檔案實作(Default.aspx)

<%@ Page Language="C#" %>
<!DOCTYPE html>
<html xmlns="https://www.w3.org/1999/xhtml">
<head runat="server">
    <title>AJAX 局部刷新 GridView 示範</title>
    <script type="text/javascript">
        function GetData(p) {
            document.getElementById("d").innerHTML = "正在讀取資料...";
            var h = window.XMLHttpRequest ? new XMLHttpRequest() : new ActiveXObject("MSXML2.XMLHTTP");
            h.open("GET", '<%=Request.FilePath %>?id=' + p.value, true);
            h.onreadystatechange = function () {
                if (h.readyState == 4) {
                    if (h.status >= 200 && h.status < 300) {
                        document.getElementById("d").innerHTML = h.responseText;
                    } else {
                        document.getElementById("d").innerHTML = "<h2>資料操作錯誤:</h2>" + h.responseText;
                    }
                }
            };
            h.send(null);
        }
        alert("此提示僅首次載入頁面時出現。");
    </script>
</head>
<body>
    <form id="form1" runat="server">
        <asp:GridView ID="GridView1" runat="server"></asp:GridView>
        <asp:Panel ID="Header" runat="server"></asp:Panel>
        <select onchange="GetData(this)">
            <option value="1">專案一</option>
            <option value="2">專案二</option>
        </select>
    </form>
    <div id="d"></div>
</body>
</html>

<script runat="server">
    // 建立測試資料來源
    System.Data.DataView CreateDataSourceByXianhuiMeng()
    {
        var dt = new System.Data.DataTable();
        dt.Columns.Add(new System.Data.DataColumn("id", typeof(int)));
        dt.Columns.Add(new System.Data.DataColumn("學生姓名", typeof(string)));
        dt.Columns.Add(new System.Data.DataColumn("語文", typeof(decimal)));
        dt.Columns.Add(new System.Data.DataColumn("數學", typeof(decimal)));
        dt.Columns.Add(new System.Data.DataColumn("英語", typeof(decimal)));
        dt.Columns.Add(new System.Data.DataColumn("計算機", typeof(decimal)));

        for (int i = 1; i < 30; i++)
        {
            var rd = new System.Random(Environment.TickCount * i);
            var dr = dt.NewRow();
            dr[0] = i;
            dr[1] = "【孟子E章】" + i;
            dr[2] = Math.Round(rd.NextDouble() * 100, 2);
            dr[3] = Math.Round(rd.NextDouble() * 100, 2);
            dr[4] = Math.Round(rd.NextDouble() * 100, 2);
            dr[5] = Math.Round(rd.NextDouble() * 100, 2);
            dt.Rows.Add(dr);
        }
        return new System.Data.DataView(dt);
    }

    protected void Page_Load(object sender, EventArgs e)
    {
        if (Request.QueryString["id"] != null)
        {
            // AJAX 請求處理:只輸出 GridView HTML
            Response.ClearContent();
            GridView1.DataSource = CreateDataSourceByXianhuiMeng();
            GridView1.DataBind();

            var sb = new System.Text.StringBuilder();
            var sw = new System.IO.StringWriter(sb);
            var htw = new HtmlTextWriter(sw);

            // 加入動態標題
            var header = new Literal();
            header.Text = "<h2>專案 " + Request.QueryString["id"] + "</h2>";
            Header.Controls.Add(header);
            Header.RenderControl(htw);
            GridView1.RenderControl(htw);

            Response.Write("這裡查詢資料,輸出結果就可以了。結果:" + sb.ToString());
            Response.End();
        }
        else
        {
            // 首次載入:正常繫結
            GridView1.DataSource = CreateDataSourceByXianhuiMeng();
            GridView1.DataBind();
        }
    }

    // 解決 "GridView 必須置於 runat=server 的表單中" 錯誤
    public override void VerifyRenderingInServerForm(Control control) { }
</script>

核心技術解析

1. 前端 AJAX 機制

  • 使用原生 XMLHttpRequest 相容 IE 與現代瀏覽器
  • 下拉選單 onchange 觸發請求,傳遞選項值作為查詢參數
  • 回應狀態 200-299 視為成功,直接將 HTML 片段注入 <div id="d">

2. 後端區分請求類型

透過 Request.QueryString["id"] 判斷:

  • 有參數:AJAX 請求,僅輸出 GridView HTML 片段,呼叫 Response.End() 終止頁面生命週期
  • 無參數:首次完整頁面載入,正常繫結資料

3. GridView 渲染為 HTML 字串

var sb = new StringBuilder();
var sw = new StringWriter(sb);
var htw = new HtmlTextWriter(sw);
GridView1.RenderControl(htw); // 將控制項輸出為 HTML 字串
string html = sb.ToString();

配合 VerifyRenderingInServerForm 覆寫,解決渲染時需在表單內的限制。

現代化改良建議

  • 使用 jQuery.ajax() 或 fetch API 簡化前端程式碼
  • 後端改回傳 JSON 資料,前端動態建立表格,分離關注點
  • 考慮使用 UpdatePanel (WebForms 內建) 或遷移至 ASP.NET Core + Blazor/WebAPI
  • 加入防呆機制:Loading 狀態、錯誤重試、防抖動

總結

本範例展示了在傳統 ASP.NET WebForms 中,以最輕量的方式實現 GridView 局部更新。雖然技術較舊,但對於維護舊系統、快速原型開發或受限環境仍具參考價值。理解其原理有助於掌握前後端非同步互動的核心概念。

copyright © 萬盛學電腦網 all rights reserved