List.ItemCommand Событие
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Происходит, когда пользователь выбирает команду, сопоставленную элементу управления 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 свойстве элемента управления, создающего событие. Это позволяет визуализировать один элемент списка с несколькими связанными взаимодействиями.
При отрисовке по умолчанию элемент управления предоставляет базовый пользовательский интерфейс, позволяющий пользователю щелкать элементы списка. При обратной отправке ItemCommand обработчик событий вызывается с аргументом типа ListCommandEventArgs, который содержит сведения об исходном элементе. Свойство CommandName этого объекта — null.
