HOW TO：回應 DataList 或 Repeater 項目中的按鈕事件

更新：2007 年 11 月

如果 DataList 或 Repeater 控制項樣板包括 Button、LinkButton 或 ImageButton Web 伺服器控制項，則這些按鈕可以將它們的 Click 事件傳送至包含 DataList 或 Repeater 控制項。這可讓您為 DataList 控制項中尚未定義的功能 (編輯、刪除、更新及取消) 加入按鈕，並為 Repeater 控制項定義功能。

若要回應 DataList 和 Repeater 控制項中的按鈕事件

1. 將 Button、LinkButton 或 ImageButton 加入至控制項樣板。

2. 將按鈕的 CommandName 屬性設定為可識別其功能的字串，例如 "sort" 或 "copy"。

3. 為包含控制項的 ItemCommand 事件建立方法。請在方法中進行以下步驟：

   1. 檢查事件引數物件的 CommandName 屬性，來檢視傳遞的字串為何。

   2. 依照使用者按下的按鈕執行適當邏輯。

   下列範例說明如何在 DataList 控制項中按一下按鈕時進行回應。在範例中，ItemTemplate 包含顯示購物車的 ImageButton 控制項。這個按鈕會傳送 AddToCart 命令。ItemCommand 事件處理常式會判斷所按的按鈕為何，如果是購物車按鈕的話，就會執行適當邏輯。

   Protected Sub DataList1_ItemCommand(ByVal source As Object, _
           ByVal e As DataListCommandEventArgs)
       If e.CommandName = "AddToCart" Then
           ' Add code here to add the item to the shopping cart.
           ' Use the value of e.Item.ItemIndex to retrieve the data 
           ' item in the control.
       End If
   End Sub
   

   protected void DataList1_ItemCommand(object source, 
       DataListCommandEventArgs e)
   {
      if (e.CommandName == "AddToCart")
      {      
         // Add code here to add the item to the shopping cart.
         // Use the value of e.Item.ItemIndex to retrieve the data 
         // item in the control.
      }
   }
   

   如需關於使用 DataList Web 伺服器控制項的範例，請參閱 HOW TO：允許使用者選取 DataList Web 伺服器控制項中的項目。

請參閱

工作

HOW TO：允許使用者編輯 DataList Web 伺服器控制項中的項目

HOW TO：允許使用者刪除 DataList Web 伺服器控制項中的項目

HOW TO：回應 GridView 控制項中的按鈕事件

參考

DataList Web 伺服器控制項概觀

Repeater Web 伺服器控制項概觀