萬盛學電腦網

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

ASP.NET Repeater 控制項資料繫結完整教學:模板、事件、條件格式化

Repeater 特性與定位

  • 輕量級:無 ViewState、無分頁/排序/編輯內建功能,僅負責**資料呈現**。
  • 完全掌控 HTML:透過模板輸出任意標記,乾淨無多餘 ``/``。
  • 效能最佳:DataBinder.Eval / `<%# Eval() %>` 晚期繫結,或強型別 `<%#: item.Property %>` (ASP.NET 4.5+)。
  • 適用場景:清單、選單、輪播、卡片版面、任何需要像素級控制 HTML 的重複性資料。
  • 五大模板完整結構

    
    
        
        
            

    <%# Eval("Name") %>

    <%# Eval("Name") %> <%# Eval("Price", "{0:C}") %>

    共 <%# ((Repeater)Container.NamingContainer).Items.Count %> 項商品

    資料繫結方式比較

    方式適用場景範例
    DataSourceID宣告式資料源`DataSourceID="odsProducts"` + ``
    DataSource + DataBind()程式碼動態指定`rpt.DataSource = GetList(); rpt.DataBind();`
    Model Binding (4.5+)強型別、可測試`SelectMethod="GetProducts"` + `ItemType="Models.Product"`

    Model Binding 範例 (強型別、IntelliSense、編譯期檢查)

    
    
    
        
            
            

    <%#: Item.Name %>

    <%#: Item.Price.ToString("C") %>
    // .aspx.cs public IQueryable GetProducts() { return _db.Products.Where(p => p.IsActive).OrderByDescending(p => p.Id); }

    ItemDataBound 事件:條件格式化、動態控制項操作

    
    protected void rptProducts_ItemDataBound(object sender, RepeaterItemEventArgs e)
    {
        // 1. 僅處理資料列
        if (e.Item.ItemType != ListItemType.Item && e.Item.ItemType != ListItemType.AlternatingItem)
            return;
    
        var product = (Product)e.Item.DataItem; // 強型別取得資料
    
        // 2. 找控制項
        var lblPrice = (Label)e.Item.FindControl("lblPrice");
        var btnAdd = (Button)e.Item.FindControl("btnAdd");
        var divCard = (HtmlGenericControl)e.Item.FindControl("divCard");
    
        // 3. 依業務邏輯調整
        if (product.IsOnSale)
        {
            lblPrice.CssClass = "price-sale";
            lblPrice.Text = $"{product.Price:C} (原價 {product.OriginalPrice:C})";
        }
    
        if (product.Stock == 0)
        {
            btnAdd.Enabled = false;
            btnAdd.Text = "缺貨中";
            divCard.Attributes["class"] += " out-of-stock";
        }
    
        // 4. 交替列額外處理 (AlternatingItem 已套用 CSS,這裡可做邏輯區分)
        if (e.Item.ItemType == ListItemType.AlternatingItem)
        {
            // 例如:偶數行顯示不同圖示
        }
    }
    

    ItemCommand 事件:處理按鈕/連結點擊

    
    protected void rptProducts_ItemCommand(object sender, RepeaterCommandEventArgs e)
    {
        if (e.CommandName == "AddToCart")
        {
            int productId = Convert.ToInt32(e.CommandArgument);
            // 業務邏輯:加入購物車
            CartService.AddItem(productId);
            // 回饋
            ScriptManager.RegisterStartupScript(this, GetType(), "toast", "showToast('已加入購物車');", true);
        }
        else if (e.CommandName == "ViewDetail")
        {
            Response.Redirect($"ProductDetail.aspx?id={e.CommandArgument}");
        }
    }
    

    巢狀 Repeater (主從關係)

    
    
        
            

    <%#: Item.Name %>

    <%#: Item.Name %>
    // 後端方法簽名需符合 SelectArguments public IQueryable GetProductsByCategory(int categoryId) { return _db.Products.Where(p => p.CategoryId == categoryId); }

    效能優化建議

    • 關閉 ViewState:`` (資料重新綁定即可)。
    • 避免 Eval 反射開銷:使用 `ItemType` + `<%#: Item.Prop %>` 強型別繫結。
    • 大量資料分頁:Repeater 本身不分頁,搭配 `PagedDataSource` 或資料庫 `OFFSET/FETCH`。
    • 輸出快取:`<%@ OutputCache Duration="60" VaryByParam="none" %>` 緩存整個 Repeater 輸出 HTML。

    現代替代方案

    | 框架 | 替代元件 | 優勢 | |------|----------|------| | **ASP.NET Core MVC / Razor Pages** | `@foreach (var item in Model) { }` | 原生 C#、強型別、Partial 重用、TagHelper | | **Blazor** | `@foreach (var item in Products) { }` | 元件化、單向/雙向綁定、WebAssembly/Server | | **前端框架 (React/Vue)** | 透過 Web API 取得 JSON,前端 `map` 渲染 | 關注點分離、豐富生態、SSR/SSG 支援 |

    Repeater 是 Web Forms 時代最純粹的資料繫結控制項,掌握其模板系統、事件模型與 Model Binding,能快速產出高品質、可維護的動態 HTML。新架構請擁抱現代渲染模式。

copyright © 萬盛學電腦網 all rights reserved