在 `OnItemCommand` 事件中,`e.Item` 即為觸發命令的 `RepeaterItem` (命名容器),直接呼叫 `FindControl` 即可取得該行內的任何伺服器控制項,無需迴圈、無需索引計算。
<table>
<asp:Repeater ID="rptList" runat="server" OnItemCommand="rptList_ItemCommand">
<HeaderTemplate>
<tr><th>數量</th><th>操作</th></tr>
</HeaderTemplate>
<ItemTemplate>
<tr>
<td>
<asp:TextBox ID="txtNum" runat="server" Text='<%# Eval("ProNum") %>' />
</td>
<td>
<asp:Button ID="btnUpdate" runat="server" Text="更新"
CommandName="update" CommandArgument='<%# Eval("PID") %>' />
</td>
</tr>
</ItemTemplate>
<FooterTemplate>
</table>
</FooterTemplate>
</asp:Repeater>
protected void rptList_ItemCommand(object source, RepeaterCommandEventArgs e)
{
switch (e.CommandName)
{
case "update":
// 1. 取得 CommandArgument (主鍵 ID)
string pid = e.CommandArgument.ToString();
// 2. 【核心】取得同一行的 TextBox 控制項
TextBox txtNum = e.Item.FindControl("txtNum") as TextBox;
if (txtNum == null) return; // 防禦性程式設計
string newQty = txtNum.Text;
// 3. 執行業務邏輯 (更新資料庫等)
// bool success = ProductService.UpdateQuantity(pid, newQty);
// 4. 前端回饋
string js = $"alert('更新成功! PID:{pid}, 新數量:{newQty}');";
ClientScript.RegisterClientScriptBlock(this.GetType(), "alert", js, true);
break;
// 可擴充 delete, edit, cancel 等命令
}
// 重新繫結資料 (視需求)
BindData();
}
private void BindData()
{
// 模擬資料
var dt = new DataTable();
dt.Columns.Add("PID");
dt.Columns.Add("ProNum");
dt.Rows.Add("1", "10");
dt.Rows.Add("2", "20");
rptList.DataSource = dt;
rptList.DataBind();
}
| 場景 | 做法 |
|---|---|
| 取得多個控制項值 | 多次呼叫 `e.Item.FindControl("id1")`, `FindControl("id2")` |
| 巢狀 Repeater (子清單) | 外層 `ItemCommand` 中 `e.Item.FindControl("innerRepeater")` 取得內層 Repeater,再處理其事件 |
| 動態產生的控制項 | 確保 `ItemTemplate` 中控制項 `ID` 固定,`FindControl` 即可運作 |
| 取得資料項完整物件 | `DataRowView drv = (DataRowView)e.Item.DataItem;` (僅 `ItemDataBound` 可用),`ItemCommand` 時 `DataItem` 為 null,需透過主鍵重查或存 ViewState |
`Repeater` + `OnItemCommand` + `e.Item.FindControl()` 是 Web Forms 時代處理「列表行內編輯/操作」最標準、最高效的模式。核心在於理解 **`RepeaterItem` 即命名容器**,`FindControl` 範圍自然限制在該行。掌握此模式,配合 `CommandName`/`CommandArgument` 傳遞指令與識別碼,即可構建功能完整、程式碼清晰的互動式資料列表。