Command.ItemCommand Command.ItemCommand Command.ItemCommand Command.ItemCommand Event

Определение

Происходит, когда пользователь выбирает команду, сопоставленную с элементом ObjectList.Occurs when the user selects a command that is associated with an ObjectList item. Этот API устарел.This API is obsolete. Дополнительные сведения о разработке мобильных приложений ASP.NET см. в статье Mobile Apps & Sites with ASP.NET (Разработка мобильных приложений и сайтов с помощью ASP.NET).For information about how to develop ASP.NET mobile applications, see Mobile Apps & Sites with 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 

Примеры

В следующем примере кода показано, ItemCommand как использовать событие для нескольких команд на странице.The following code example demonstrates how to use the ItemCommand event for multiple commands on a page.

<%@ 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>

Комментарии

Если обработчик Command событий определен, элемент управления уведомляет обработчик о том, что событие элемента создается при взаимодействии с пользователем. ItemCommandWhen an ItemCommand event handler is defined, the Command control notifies the handler when an item event is generated through user interaction.

Click ВItemCommand отличие от события, событие передается в родительские элементы управления.Unlike the Click event, the ItemCommand event is bubbled up to the parent controls. Отрисовка System.Web.UI.MobileControls.Commandсобытий зависит от конкретного устройства и подробно рассматривается в разделе "поведение конкретного устройства" раздела. ItemCommandThe ItemCommand event rendering is device-specific and is discussed in detail in the "Device-Specific Behavior" section of System.Web.UI.MobileControls.Command.

OnItemCommand Событие возникаетOnClick после события.The OnItemCommand event is raised after an OnClick event. В ситуации, когда один и тот же набор действий повторяется каждый раз при нажатии кнопки Command, можно использовать CommandName свойство Command или CommandArgument элемента управления, чтобы определить, какая команда нажата пользователем.In a scenario where you repeat the same set of actions each time a command button is clicked, you can use either the CommandName or CommandArgument property of the Command control to identify which command button the user clicked.

Применяется к

Дополнительно