Gewusst wie: Reagieren auf Schaltflächenereignisse in DataList- oder Repeater-Elementen

Aktualisiert: November 2007

Wenn eine DataList-Steuerelementvorlage oder eine Repeater-Steuerelementvorlage ein Button-Webserversteuerelement, ein LinkButton-Webserversteuerelement oder ein ImageButton-Webserversteuerelement enthält, können diese Schaltflächen die Click-Ereignisse an das übergeordnete DataList-Steuerelement oder Repeater-Steuerelement senden. Auf diese Weise können Sie Schaltflächen für Funktionen einfügen, die für das DataList-Steuerelement noch nicht definiert wurden (Bearbeiten, Löschen, Aktualisieren und Abbrechen), sowie Funktionen für das Repeater-Steuerelement definieren.

So reagieren Sie auf Schaltflächenereignisse im DataList-Steuerelement und im Repeater-Steuerelement

1. Fügen Sie Button, LinkButton oder ImageButton in eine Steuerelementvorlage ein.

2. Setzen Sie die CommandName-Eigenschaft der Schaltfläche auf eine Zeichenfolge fest, die ihre Funktion kennzeichnet, z. B. "sortieren" oder "kopieren".

3. Erstellen Sie eine Methode für das ItemCommand-Ereignis des übergeordneten Steuerelements. Verfahren Sie in der Methode wie folgt:

   1. Überprüfen Sie die CommandName-Eigenschaft des Ereignisargumentobjekts, um herauszufinden, welche Zeichenfolge übergeben wurde.

   2. Führen Sie die entsprechende Logik für die vom Benutzer ausgewählte Schaltfläche aus.

   Im folgenden Beispiel wird gezeigt, wie in einem DataList-Steuerelement auf das Klicken auf eine Schaltfläche reagiert werden kann. In diesem Beispiel enthält die ItemTemplate ein ImageButton-Steuerelement, das einen Einkaufswagen anzeigt. Die Schaltfläche sendet den Befehl AddToCart. Der ItemCommand-Ereignishandler bestimmt, auf welche Schaltfläche geklickt wurde und führt – sofern es die Einkaufswagen-Schaltfläche war – die entsprechende Logik aus.

   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.
      }
   }
   

   Ein Beispiel mit dem DataList-Webserversteuerelement finden Sie unter Gewusst wie: Ermöglichen des Auswählens von Elementen in DataList-Webserversteuerelementen.

Siehe auch

Aufgaben

Gewusst wie: Ermöglichen des Bearbeitens von Elementen in DataList-Webserversteuerelementen

Gewusst wie: Ermöglichen des Löschens von Elementen in DataList-Webserversteuerelementen

Gewusst wie: Reagieren auf Schaltflächenereignisse in einem GridView-Steuerelement

Referenz

Übersicht über das DataList-Webserversteuerelement

Übersicht über das Repeater-Webserversteuerelement