List.ItemCommand Ereignis

  • Referenz

Definition

Namespace:
System.Web.UI.MobileControls
Assembly:
System.Web.Mobile.dll

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

ListCommandEventHandler

Beispiele

Im folgenden Codebeispiel wird gezeigt, wie das ItemCommand Ereignis zum Aufrufen einer Methode verwendet wird, die die status eines Elements in der Liste ändert und die status Summen 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