List.ItemCommand Evento
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
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
.