Freigeben über


List.ItemCommand Ereignis

Definition

Tritt ein, wenn der Benutzer einen Befehl auswählt, der einem List-Steuerelement zugeordnet ist. Diese API ist veraltet. Informationen zum Entwickeln ASP.NET mobiler Anwendungen finden Sie unter Mobile Apps & Sites mit ASP.NET.

public:
 event System::Web::UI::MobileControls::ListCommandEventHandler ^ ItemCommand;
public event System.Web.UI.MobileControls.ListCommandEventHandler ItemCommand;
member this.ItemCommand : System.Web.UI.MobileControls.ListCommandEventHandler 
Public Custom Event ItemCommand As ListCommandEventHandler 

Ereignistyp

Beispiele

Das folgende Codebeispiel zeigt, wie sie mithilfe des ItemCommand -Ereignisses eine Methode aufrufen, die den Status eines Elements in der Liste ändert und die Statussummen neu berechnet. Dieses Beispiel ist Teil eines größeren Beispiels für die List Übersicht.

private void Status_ItemCommand(object sender, 
    ListCommandEventArgs e)
{
    const string spec = "You now have {0} " + 
        "tasks done, {1} tasks scheduled, and " +
        "{2} tasks pending.";

    // Move selection to next status toward 'done'
    switch (e.ListItem.Value)
    {
        case "scheduled":
            schedCount -= 1;
            pendCount += 1;
            e.ListItem.Value = "pending";
            break;
        case "pending":
            pendCount -= 1;
            doneCount += 1;
            e.ListItem.Value = "done";
            break;
    }

    // Show the status of the current task
    Label1.Text = e.ListItem.Text + " is " +
        e.ListItem.Value;

    // Show current selection counts
    Label2.Text = String.Format(spec, doneCount, 
        schedCount, pendCount);
}
Private Sub Status_ItemCommand(ByVal sender As Object, _
    ByVal e As ListCommandEventArgs)

    Const spec As String = "You now have {0} tasks done, {1} " & _
        "tasks scheduled, and {2} tasks pending."

    ' Move selection to next status toward 'done'
    Select Case e.ListItem.Value
        Case "scheduled"
            schedCount -= 1
            pendCount += 1
            e.ListItem.Value = "pending"
        Case "pending"
            pendCount -= 1
            doneCount += 1
            e.ListItem.Value = "done"
            
    End Select

    ' Show the status of the current task
    Label1.Text = e.ListItem.Text & " is " & _
        e.ListItem.Value

    ' Show current selection counts
    Label2.Text = String.Format(spec, doneCount, _
        schedCount, pendCount)
End Sub

Hinweise

Wenn Sie eine Liste mithilfe von Vorlagen rendern, wird der ItemCommand Ereignishandler über den Ereignisbubblingmechanismus von ASP.NET aufgerufen. Dem Ereignishandler wird ein Argument vom Typ ListCommandEventArgsübergeben, das Informationen über das Quellelement und die CommandName -Eigenschaft des Steuerelements enthält, das das Ereignis generiert hat. Dadurch können Sie ein einzelnes Listenelement mit mehreren zugehörigen Interaktionen rendern.

Beim Standardrendering stellt das Steuerelement eine einfache Benutzeroberfläche (UI) bereit, mit der der Benutzer auf Listenelemente klicken kann. Beim Postback wird der ItemCommand Ereignishandler mit einem Argument vom Typ ListCommandEventArgsaufgerufen, das Informationen zum Quellelement enthält. Die CommandName -Eigenschaft dieses Objekts ist null.

Gilt für:

Weitere Informationen