List.ItemCommand Evento

Definizione

Si verifica quando l'utente seleziona un comando che viene associato a un controllo List. Questa API è obsoleta. Per informazioni su come sviluppare applicazioni ASP.NET per dispositivi mobili, vedere App per dispositivi mobili & Siti con 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 

Tipo evento

Esempio

Nell'esempio di codice seguente viene illustrato come utilizzare l'evento ItemCommand per chiamare un metodo che modifica lo stato di un elemento nell'elenco e ricalcola i totali dello stato. Questo esempio fa parte di un esempio più ampio per la List panoramica.

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

Commenti

Quando si esegue il rendering di un elenco usando i modelli, il ItemCommand gestore eventi viene chiamato tramite il meccanismo di bubbling degli eventi di ASP.NET. Il gestore eventi viene passato un argomento di tipo ListCommandEventArgs, che contiene informazioni sull'elemento di origine e sulla CommandName proprietà del controllo che ha generato l'evento. In questo modo è possibile eseguire il rendering di una singola voce di elenco con più interazioni associate.

Durante il rendering predefinito, il controllo fornisce un'interfaccia utente di base che consente all'utente di fare clic su voci di elenco. Al postback, il ItemCommand gestore eventi viene chiamato con un argomento di tipo ListCommandEventArgs, che contiene informazioni sull'elemento di origine. La CommandName proprietà di questo oggetto è null.

Si applica a

Vedi anche