萬盛學電腦網

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

ASP.NET GridView 實現伺服器端與客戶端雙模式全選功能完整教學

功能需求

在資料表格中提供「全選/取消全選」功能是常見需求。本文示範兩種實作方式:

  1. 伺服器端全選:使用 asp:CheckBox 配合 AutoPostBack,回傳伺服器處理
  2. 客戶端全選:使用 HTML <input type="checkbox"> 搭配 JavaScript,無需回傳,體驗更流暢

完整程式碼實作 (Default.aspx)

<%@ Page Language="C#" AutoEventWireup="true" %>
<!DOCTYPE html>
<html xmlns="https://www.w3.org/1999/xhtml">
<head>
    <title>GridView 全選功能示範</title>
    <script type="text/javascript">
        // 客戶端全選邏輯
        function CheckAll(oCheckbox) {
            var gridView2 = document.getElementById("<%=GridView2.ClientID %>");
            for (var i = 1; i < gridView2.rows.length; i++) {
                // 取得每列第一個儲存格中的 checkbox
                var chk = gridView2.rows[i].cells[0].getElementsByTagName("INPUT")[0];
                if (chk) chk.checked = oCheckbox.checked;
            }
        }
    </script>
</head>
<body>
    <form id="Form1" runat="server">
        <table style="width:800px;font-size:12px;">
            <tr valign="top">
                <td>
                    <!-- 伺服器端全選 GridView1 -->
                    <asp:GridView ID="GridView1" runat="server" Font-Size="12px" BackColor="#FFFFFF"
                        GridLines="Both" CellPadding="4" DataKeyNames="序號" AutoGenerateColumns="false">
                        <HeaderStyle BackColor="#EDEDED" Height="26px"/>
                        <Columns>
                            <asp:TemplateField>
                                <HeaderTemplate>
                                    <asp:CheckBox ID="CheckBox1" runat="server" Text="全選" 
                                        AutoPostBack="true" OnCheckedChanged="CheckAll"/>
                                </HeaderTemplate>
                                <ItemTemplate>
                                    <asp:CheckBox ID="ItemCheckBox" runat="server"/>
                                </ItemTemplate>
                            </asp:TemplateField>
                            <asp:BoundField DataField="學生姓名" HeaderText="學生姓名"/>
                            <asp:BoundField DataField="語文" HeaderText="語文"/>
                            <asp:BoundField DataField="數學" HeaderText="數學"/>
                            <asp:BoundField DataField="英語" HeaderText="英語"/>
                            <asp:BoundField DataField="計算機" HeaderText="計算機"/>
                        </Columns>
                    </asp:GridView>
                    <asp:Button ID="Button1" runat="server" OnClick="Button1_Click" Text="取得選取行值"/>
                </td>
                <td align="right">
                    <!-- 客戶端全選 GridView2 -->
                    <asp:GridView ID="GridView2" runat="server" Font-Size="12px" BackColor="#FFFFFF"
                        GridLines="Both" CellPadding="4" DataKeyNames="序號" AutoGenerateColumns="false">
                        <HeaderStyle BackColor="#EDEDED" Height="26px"/>
                        <Columns>
                            <asp:TemplateField>
                                <HeaderTemplate>
                                    <input id="Checkbox2" type="checkbox" onclick="CheckAll(this)" runat="server"/><label>全選</label>
                                </HeaderTemplate>
                                <ItemTemplate>
                                    <asp:CheckBox ID="ItemCheckBox" runat="server"/>
                                </ItemTemplate>
                            </asp:TemplateField>
                            <asp:BoundField DataField="學生姓名" HeaderText="學生姓名"/>
                            <asp:BoundField DataField="語文" HeaderText="語文"/>
                            <asp:BoundField DataField="數學" HeaderText="數學"/>
                            <asp:BoundField DataField="英語" HeaderText="英語"/>
                            <asp:BoundField DataField="計算機" HeaderText="計算機"/>
                        </Columns>
                    </asp:GridView>
                    <asp:Button ID="Button2" runat="server" OnClick="Button2_Click" Text="取得選取行值"/>
                </td>
            </tr>
        </table>
        <div>
            <asp:Label ID="Ret1" runat="server" />
            <asp:Label ID="Ret2" runat="server" />
        </div>
    </form>
</body>
</html>

<script runat="server">
    // 建立測試資料
    ICollection CreateDataSource()
    {
        var dt = new System.Data.DataTable();
        dt.Columns.Add(new System.Data.DataColumn("序號", typeof(string)));
        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 = 0; i < 8; i++)
        {
            var rd = new System.Random(Environment.TickCount * i);
            var dr = dt.NewRow();
            dr[0] = i.ToString();
            dr[1] = "【孟子】" + 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 (!IsPostBack)
        {
            GridView1.DataSource = GridView2.DataSource = CreateDataSource();
            GridView1.DataBind();
            GridView2.DataBind();
        }
    }

    // 伺服器端:取得 GridView1 選取項目
    protected void Button1_Click(object sender, EventArgs e)
    {
        Ret1.Text = "";
        foreach (GridViewRow gvr in GridView1.Rows)
        {
            var ch = (CheckBox)gvr.FindControl("ItemCheckBox");
            if (ch.Checked)
            {
                Ret1.Text += "<li>GridView1 您選擇的是(鍵值):" + GridView1.DataKeys[gvr.DataItemIndex].Value + "</li>";
            }
        }
    }

    // 伺服器端:取得 GridView2 選取項目
    protected void Button2_Click(object sender, EventArgs e)
    {
        Ret2.Text = "";
        foreach (GridViewRow gvr in GridView2.Rows)
        {
            var ch = (CheckBox)gvr.FindControl("ItemCheckBox");
            if (ch.Checked)
            {
                Ret2.Text += "<li>GridView2 您選擇的是(鍵值):" + GridView2.DataKeys[gvr.DataItemIndex].Value + "</li>";
            }
        }
    }

    // 伺服器端全選事件處理
    protected void CheckAll(object sender, EventArgs e)
    {
        var cbx = (CheckBox)sender;
        foreach (GridViewRow gvr in GridView1.Rows)
        {
            var ch = (CheckBox)gvr.FindControl("ItemCheckBox");
            ch.Checked = cbx.Checked;
        }
    }
</script>

兩種模式詳細比較

特性伺服器端全選客戶端全選
實作控制項asp:CheckBoxHTML input type="checkbox"
觸發機制AutoPostBack="true" + OnCheckedChangedonclick="CheckAll(this)" JavaScript
網路傳輸完整回傳無網路請求
回應速度較慢(需往返伺服器)即時
狀態保持自動保持(ViewState)需自行管理(或回傳時重讀)
適用場景需即時在伺服器處理選取資料純前端互動、大量資料、追求體驗

關鍵技術點

1. DataKeyNames 取得主鍵值

設定 DataKeyNames="序號",在伺服器端透過 GridView1.DataKeys[gvr.DataItemIndex].Value 安全取得主鍵,避免在頁面暴露 ID。

2. FindControl 取得模板欄位控制項

var ch = (CheckBox)gvr.FindControl("ItemCheckBox");

必須在 GridViewRow 層級尋找,不可直接在 GridView 層級尋找。

3. 客戶端 DOM 遍歷技巧

var gridView2 = document.getElementById("<%=GridView2.ClientID %>");
for (var i = 1; i < gridView2.rows.length; i++) { // i=1 跳過標題列
    var chk = gridView2.rows[i].cells[0].getElementsByTagName("INPUT")[0];
    chk.checked = oCheckbox.checked;
}

利用 ClientID 取得實際渲染 ID,遍歷表格列、儲存格、取得 checkbox 並同步狀態。

進階擴充建議

  • 保持客戶端選取狀態回傳:在表單送出前,將客戶端 checkbox 狀態同步到隱藏欄位或 asp:CheckBox
  • 加入「反選」功能:擴充 JavaScript 函數支援反選邏輯
  • 分頁情境下的全選:需配合伺服器端資料源處理跨頁選取
  • 無障礙支援:加入 label 標籤關聯 checkbox,支援鍵盤操作

總結

伺服器端全選實作簡單、狀態自動管理,適合需即時處理選取資料的場景;客戶端全選體驗佳、無回傳負擔,適合大量資料或追求流暢互動的場合。實務上可根據業務需求選擇,甚至混合使用:客戶端負責即時互動,回傳時再同步至伺服器端控制項。

copyright © 萬盛學電腦網 all rights reserved