List.ItemCommand 事件
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
在用户选择与 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
事件类型
示例
下面的代码示例演示如何使用 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
。