List.ItemCommand 이벤트

정의

사용자가 List 컨트롤과 연결된 명령을 선택할 때 이 이벤트가 발생합니다.Occurs when the user selects a command that is associated with a List control. 이 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::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 이벤트를 사용 하 여 목록에 있는 항목의 상태를 변경 하 고 상태 합계를 다시 계산 하는 메서드를 호출 하는 방법을 보여 줍니다.The following code example shows how to use the ItemCommand event to call a method that changes the status of an item in the list and recalculates the status totals. 이 예제는에 대 한 보다 큰 예제의 일부는 List 개요.This example is part of a larger example for the List overview.

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

설명

템플릿을 사용 하 여 목록을 렌더링 하면 ASP.NET의 이벤트 버블링 메커니즘을 통해 ItemCommand 이벤트 처리기가 호출 됩니다.When you render a list by using templates, the ItemCommand event handler is called through the event-bubbling mechanism of ASP.NET. 이벤트 처리기는 ListCommandEventArgs형식의 인수를 전달 합니다 .이 인수에는 이벤트를 생성 한 컨트롤의 소스 항목 및 CommandName 속성에 대 한 정보가 포함 됩니다.The event handler is passed an argument of type ListCommandEventArgs, which contains information about the source item and the CommandName property of the control that generated the event. 이 옵션을 사용 하면 여러 관련된 상호 작용을 사용 하 여 단일 목록 항목을 렌더링할 수 있습니다.This allows you to render a single list item with multiple associated interactions.

기본 렌더링 컨트롤 목록 항목을 클릭 하 여 사용자를 허용 하는 기본 사용자 인터페이스 (UI)를 제공 합니다.On default rendering, the control provides a basic user interface (UI) that allows the user to click list items. 다시 게시 시 원본 항목에 대 한 정보가 포함 된 ListCommandEventArgs형식의 인수를 사용 하 여 ItemCommand 이벤트 처리기가 호출 됩니다.On postback, the ItemCommand event handler is called with an argument of type ListCommandEventArgs, which contains information about the source item. 이 개체의 CommandName 속성은 null입니다.The CommandName property of this object is null.

적용 대상

추가 정보