在資料表格中提供「全選/取消全選」功能是常見需求。本文示範兩種實作方式:
asp:CheckBox 配合 AutoPostBack,回傳伺服器處理<input type="checkbox"> 搭配 JavaScript,無需回傳,體驗更流暢<%@ 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:CheckBox | HTML input type="checkbox" |
| 觸發機制 | AutoPostBack="true" + OnCheckedChanged | onclick="CheckAll(this)" JavaScript |
| 網路傳輸 | 完整回傳 | 無網路請求 |
| 回應速度 | 較慢(需往返伺服器) | 即時 |
| 狀態保持 | 自動保持(ViewState) | 需自行管理(或回傳時重讀) |
| 適用場景 | 需即時在伺服器處理選取資料 | 純前端互動、大量資料、追求體驗 |
設定 DataKeyNames="序號",在伺服器端透過 GridView1.DataKeys[gvr.DataItemIndex].Value 安全取得主鍵,避免在頁面暴露 ID。
var ch = (CheckBox)gvr.FindControl("ItemCheckBox");
必須在 GridViewRow 層級尋找,不可直接在 GridView 層級尋找。
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 並同步狀態。
asp:CheckBoxlabel 標籤關聯 checkbox,支援鍵盤操作伺服器端全選實作簡單、狀態自動管理,適合需即時處理選取資料的場景;客戶端全選體驗佳、無回傳負擔,適合大量資料或追求流暢互動的場合。實務上可根據業務需求選擇,甚至混合使用:客戶端負責即時互動,回傳時再同步至伺服器端控制項。