方法 : DataList 項目または Repeater 項目のボタンイベントに応答する

[アーティクル]
10/22/2014

更新 : 2007 年 11 月

DataList コントロールまたは Repeater コントロールのテンプレートに、Button Web サーバーコントロール、LinkButton Web サーバーコントロール、または ImageButton Web サーバーコントロールが含まれている場合、これらのボタンは、ボタンを含む DataList コントロールまたは Repeater コントロールに Click イベントを送信できます。したがって、DataList コントロールに定義されていない機能のボタン (編集、削除、更新、キャンセル) を含めたり、Repeater コントロールの機能を定義したりできます。

DataList コントロールと Repeater コントロールのボタンイベントに応答するには

コントロールテンプレートに Button、LinkButton、または ImageButton を含めます。
ボタンの CommandName プロパティに、"sort" や "copy" など、機能を示す文字列を設定します。
ボタンを含むコントロールの ItemCommand イベントのメソッドを作成します。このメソッドでは、次の処理を行います。
1. イベント引数オブジェクトの CommandName プロパティをチェックして、どのようなコマンド文字列が渡されたかを確認します。
2. ユーザーがクリックしたボタンに対して適切なロジックを実行します。
次の例では、DataList コントロールにおけるボタンクリックへの応答方法を示しています。この例では、買い物カゴを表示する ImageButton が ItemTemplate に含まれています。このボタンは 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 サーバーコントロールの使用例については、「方法 : ユーザーが DataList Web サーバーコントロール内の項目を選択できるようにする」を参照してください。