List.ItemCommand Evento
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Ocorre quando o usuário seleciona um comando que está associado a um controle List. Esta API está obsoleta. Para obter informações sobre como desenvolver aplicativos móveis ASP.NET, consulte Aplicativos Móveis & Sites com 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 de evento
Exemplos
O exemplo de código a seguir mostra como usar o ItemCommand evento para chamar um método que altera o status de um item na lista e recalcula os totais de status. Este exemplo faz parte de um exemplo maior para a List visão geral.
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
Comentários
Quando você renderiza uma lista usando modelos, o ItemCommand manipulador de eventos é chamado por meio do mecanismo de propagação de eventos de ASP.NET. O manipulador de eventos é passado um argumento do tipo ListCommandEventArgs, que contém informações sobre o item de origem e a CommandName propriedade do controle que gerou o evento. Isso permite renderizar um único item de lista com várias interações associadas.
Na renderização padrão, o controle fornece uma interface do usuário (interface do usuário) básica que permite que o usuário clique em itens de lista. No postback, o ItemCommand manipulador de eventos é chamado com um argumento do tipo ListCommandEventArgs, que contém informações sobre o item de origem. A CommandName propriedade desse objeto é null.
