Command.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 item ObjectList. 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::WebControls::CommandEventHandler ^ ItemCommand;
public event System.Web.UI.WebControls.CommandEventHandler ItemCommand;
member this.ItemCommand : System.Web.UI.WebControls.CommandEventHandler
Public Custom Event ItemCommand As CommandEventHandler
Tipo de evento
Exemplos
O exemplo de código a seguir demonstra como usar o ItemCommand evento para vários comandos em uma página.
<%@ Page Language="C#"
Inherits="System.Web.UI.MobileControls.MobilePage" %>
<%@ Register TagPrefix="mobile"
Namespace="System.Web.UI.MobileControls"
Assembly="System.Web.Mobile" %>
<script runat="server">
void cmd_OnItemCommand(object sender, CommandEventArgs e)
{
// Create variables for data
string txt1 = "Today's quote of {0} is {1}";
string txt2 = "Yesterday's quote of {0} was {1}";
int val = (Convert.ToInt32(e.CommandArgument) - 5);
// Set the text values of the labels
message1.Text = String.Format(txt1, e.CommandName,
e.CommandArgument);
message2.Text = String.Format(txt2, e.CommandName, val);
}
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<body>
<mobile:form id="form1" runat="server">
<p>
<mobile:label id="message1" runat="server">
Click the button for quotes
</mobile:label>
<mobile:label id="message2" runat="server" />
</p>
<mobile:command id="CmdA" Format="Link"
onItemCommand ="cmd_OnItemCommand"
CommandArgument="70" CommandName="ca"
runat="server" Text="Company A" />
<mobile:command id="CmdB" Format="Link"
onItemCommand ="cmd_OnItemCommand"
CommandArgument="25" CommandName="cb"
runat="server" Text="Company B" />
<mobile:command id="CmdC" Format="Button"
OnItemCommand ="cmd_OnItemCommand"
CommandArgument="110" CommandName="cc"
runat="server" Text= "Company C" />
</mobile:form>
</body>
</html>
<%@ Page Language="VB"
Inherits="System.Web.UI.MobileControls.MobilePage" %>
<%@ Register TagPrefix="mobile"
Namespace="System.Web.UI.MobileControls"
Assembly="System.Web.Mobile" %>
<script runat="server">
Private Sub cmd_OnItemCommand(ByVal sender As Object, ByVal e As CommandEventArgs)
' Create variables for data
Dim txt1 As String = "Today's quote of {0} is {1}"
Dim txt2 As String = "Yesterday's quote of {0} was {1}"
Dim Val As Integer = (Convert.ToInt32(e.CommandArgument) - 5)
' Set the text values of the labels
message1.Text = String.Format(txt1, e.CommandName, _
e.CommandArgument)
message2.Text = String.Format(txt2, e.CommandName, Val)
End Sub
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<body>
<mobile:form id="form1" runat="server">
<p>
<mobile:label id="message1" runat="server">
Click the button for quotes
</mobile:label>
<mobile:label id="message2" runat="server" />
</p>
<mobile:command id="CmdA" Format="Link"
onItemCommand="cmd_OnItemCommand"
CommandArgument="70" CommandName="ca"
runat="server" Text="Company A" />
<mobile:command id="CmdB" Format="Link"
onItemCommand ="cmd_OnItemCommand"
CommandArgument="25" CommandName="cb"
runat="server" Text="Company B" />
<mobile:command id="CmdC" Format="Button"
OnItemCommand="cmd_OnItemCommand"
CommandArgument="110" CommandName="cc"
runat="server" Text="Company C" />
</mobile:form>
</body>
</html>
Comentários
Quando um ItemCommand manipulador de eventos é definido, o Command controle notifica o manipulador quando um evento de item é gerado por meio da interação do usuário.
Ao contrário do Click evento, o ItemCommand evento é gerado até os controles pai. A ItemCommand renderização de eventos é específica do dispositivo e é discutida em detalhes na seção "Comportamento específico do dispositivo" de System.Web.UI.MobileControls.Command.
O OnItemCommand evento é gerado após um OnClick evento. Em um cenário em que você repete o mesmo conjunto de ações sempre que um botão de comando é clicado, você pode usar a CommandName propriedade ou CommandArgument do Command controle para identificar qual botão de comando o usuário clicou.