List.ItemCommand 事件

  • 参考

定义

命名空间:
System.Web.UI.MobileControls
程序集:
System.Web.Mobile.dll

在用户选择与 List 控件关联的命令时发生。 此 API 已废弃不用。 有关如何开发 ASP.NET 移动应用程序的信息，请参阅 移动应用 & 具有 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

事件类型

ListCommandEventHandler

示例

下面的代码示例演示如何使用 ItemCommand 事件调用方法，该方法可更改列表中项的状态并重新计算状态总计。 此示例是概述的较大示例的 List 一部分。

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

注解

使用模板呈现列表时， ItemCommand 事件处理程序将通过 ASP.NET 的事件浮升机制调用。 事件处理程序将传递类型 ListCommandEventArgs为 的参数，该参数包含有关生成事件的控件的源项和 CommandName 属性的信息。 这样，就可以呈现具有多个关联交互的单个列表项。

在默认呈现时，控件提供基本的用户界面 (UI) ，允许用户单击列表项。 回发时 ItemCommand ，事件处理程序使用 类型 ListCommandEventArgs为 的参数调用，该参数包含有关源项的信息。 此 CommandName 对象的 属性为 null。

适用于

另请参阅