萬盛學電腦網

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

ASP.NET Repeater OnItemCommand 取得行內控制項完整範例:FindControl 最佳實踐

Repeater 控制項優勢回顧

  • **無預設版面**:完全由開發者控制 HTML 輸出,乾淨、語意化、利於 SEO 與 CSS。
  • **輕量**:無 ViewState 膨脹 (除非啟用)、無複雜生命週期、渲染速度最快。
  • **彈性**:`ItemTemplate`、`AlternatingItemTemplate`、`HeaderTemplate`、`FooterTemplate`、`SeparatorTemplate` 任意組合。

核心技巧:e.Item.FindControl("控制項ID")

在 `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

常見錯誤與避坑

  • ❌ **在 `Page_Load` 中 `FindControl`** → `Repeater` 尚未 `DataBind`,控制項不存在。
  • ❌ **使用 `rptList.Items[i].FindControl(...)` 且索引錯誤** → 分頁、排序後索引不對應資料列。
  • ✅ **永遠在 `ItemCommand` / `ItemDataBound` 事件中使用 `e.Item.FindControl()`** → 唯一正確時機點。
  • ✅ **`CommandArgument` 傳遞主鍵** → 避免依賴 `RowIndex` 或 Session 傳遞參數。

現代化對比

  • ASP.NET Core Razor Pages:`@foreach` 直接產生 `
    `,每行獨立表單,後端 `OnPostUpdate(string id, string qty)` 直接模型繫結,無需 `FindControl`。
  • Blazor:`@foreach` 渲染元件 ``,事件回呼直接拿到強型別物件。

總結

`Repeater` + `OnItemCommand` + `e.Item.FindControl()` 是 Web Forms 時代處理「列表行內編輯/操作」最標準、最高效的模式。核心在於理解 **`RepeaterItem` 即命名容器**,`FindControl` 範圍自然限制在該行。掌握此模式,配合 `CommandName`/`CommandArgument` 傳遞指令與識別碼,即可構建功能完整、程式碼清晰的互動式資料列表。

copyright © 萬盛學電腦網 all rights reserved