使用英语阅读

通过

ObjectList.ItemCommand 事件

  • 参考

定义

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

在用户选择与 ObjectList 项关联的命令时发生。 此 API 已废弃不用。 有关如何开发 ASP.NET 移动应用程序的信息，请参阅 移动应用 & 具有 ASP.NET 的网站。

public event System.Web.UI.MobileControls.ObjectListCommandEventHandler ItemCommand;

事件类型

ObjectListCommandEventHandler

示例

下面的代码示例演示如何捕获 ItemCommand 事件。 属性 CommandName 指定要执行的操作。

备注

下面的代码示例使用单文件代码模型，如果直接复制到代码隐藏文件中，可能无法正常工作。 此代码示例必须复制到扩展名为 .aspx 的空文本文件中。 有关详细信息，请参阅 ASP.NET Web 窗体页代码模型。

<%@ Page Language="C#" 
    Inherits="System.Web.UI.MobileControls.MobilePage" %>
<%@ Register TagPrefix="mobile" 
    Namespace="System.Web.UI.MobileControls" 
    Assembly="System.Web.Mobile" %>

<script runat="server">
    //System.Web.UI.MobileControls.ObjectListItem item;
    //System.Web.UI.MobileControls.ObjectListItemCollection itemColl;
    // Get the persisted array through postbacks.
    ArrayList arr = new ArrayList();
    public void Page_Load(Object sender, EventArgs e)
    {
        if (!IsPostBack)
        {
            // Create and fill the array
            arr.Add(new Task("Tomorrow's work", "Yes", 1));
            arr.Add(new Task("Today's work", "Yes", 1));
            arr.Add(new Task("Yesterday's work", "No", 1));
            
            // Persist the array in the Session object
            Session["MyArrayList"] = arr;

            // Associate and bind array to the 
            // ObjectList for each postback.
            ObjectList1.DataSource = arr;
            ObjectList1.LabelField = "TaskName";
            ObjectList1.DataBind();
        }
    }

    private void ItemCommand_Click(Object sender, 
        ObjectListCommandEventArgs e)
    {
        // Get the array from the Session object
        arr = (ArrayList)Session["MyArrayList"];

        // Remove selected item from the ObjectLis
        int i = ObjectList1.SelectedIndex;
        arr.RemoveAt(i);
        Session["MyArrayList"] = arr;

        // Re-Bind ObjectList to altered ArrayList.
        ObjectList1.DataSource = arr;
        ObjectList1.LabelField = "TaskName";
        ObjectList1.DataBind();
        ObjectList1.ViewMode = ObjectListViewMode.List;
    }

    void ItemCommands_Show(Object sender, 
        ObjectListShowCommandsEventArgs e) 
    {
        // Check conditions, and add or remove 
        // commands in the detail view.
        if (e.ListItem["Editable"].Equals("No"))
            ObjectList1.Commands.RemoveAt(0);
        else if (ObjectList1.Commands.Count < 1)
            ObjectList1.Commands.Add(new 
                ObjectListCommand("Delete", "Delete"));
    }

    private class Task
    {
        private string _TaskName;
        private string _Editable;
        private int _Days;
        public Task(string TaskName, string Editable, int Days)
        {
            _TaskName = TaskName;
            _Editable = Editable;
            _Days = Days;
        }
        public string TaskName
        { get { return _TaskName; } }
        public string Editable
        { get { return _Editable; } }
        public int Days
        { get { return _Days; } }
    }
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<body>
    <mobile:Form runat="server" id="Form1" >
        <mobile:ObjectList runat="server" id="ObjectList1" 
            OnItemCommand="ItemCommand_Click" 
            OnShowItemCommands="ItemCommands_Show" >
            <Command Name="Delete" Text="Delete" />
        </mobile:ObjectList>
        <mobile:Label runat="server" id="Label1" />
        <mobile:Label runat="server" id="Label2" />
    </mobile:Form>
</body>
</html>

注解

ItemCommand定义事件处理程序时， ObjectList 会在通过用户交互生成项事件时通知处理程序。

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

在默认呈现时，控件会将为对象列表定义的每个命令呈现为链接。 当用户单击链接时， ItemCommand 事件处理程序将调用类型为 ObjectListCommandEventArgs的参数，该参数包含有关源项的信息。 属性中的 CommandName 值是用户调用的命令的名称。

适用于

产品 版本
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1

另请参阅