ListViewCommandEventArgs Class
Provides data for the ItemCommand event.
System.EventArgs
System.Web.UI.WebControls.CommandEventArgs
System.Web.UI.WebControls.ListViewCommandEventArgs
Assembly: System.Web.Extensions (in System.Web.Extensions.dll)
The ListViewCommandEventArgs type exposes the following members.
| Name | Description | |
|---|---|---|
![]() | ListViewCommandEventArgs | Initializes a new instance of the ListViewCommandEventArgs class by using the specified source of the command and event arguments. |
| Name | Description | |
|---|---|---|
![]() | CommandArgument | Gets the argument for the command. (Inherited from CommandEventArgs.) |
![]() | CommandName | Gets the name of the command. (Inherited from CommandEventArgs.) |
![]() | CommandSource | Gets the source of the command. |
![]() | Item | Gets the data item for which the command was issued. |
| Name | Description | |
|---|---|---|
![]() | Equals(Object) | Determines whether the specified Object is equal to the current Object. (Inherited from Object.) |
![]() | Finalize | Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection. (Inherited from Object.) |
![]() | GetHashCode | Serves as a hash function for a particular type. (Inherited from Object.) |
![]() | GetType | Gets the Type of the current instance. (Inherited from Object.) |
![]() | MemberwiseClone | Creates a shallow copy of the current Object. (Inherited from Object.) |
![]() | ToString | Returns a string that represents the current object. (Inherited from Object.) |
The ItemCommand event is raised when a button in the ListView control is clicked. This enables you to provide an event-handling method that performs a custom routine whenever this event occurs.
Note |
|---|
The ListView control also raises other events when certain buttons are clicked (for example, buttons with the CommandName property set to "Delete", "Update", or "Page"). When you use one of these buttons, you can handle one of the specialized events that are provided by the control, such as the ItemDeleted or ItemDeleting events. |
A ListViewCommandEventArgs object is passed to the event-handling method, which enables you to determine the command name and command argument of the button that was clicked. To determine the command name use the CommandName property, and to determine the command argument, use the CommandArgument property. You can also access the button control that raised the event by using the CommandSource property.
For a list of initial property values for an instance of the ListViewCommandEventArgs class, see the ListViewCommandEventArgs constructor.
The following example shows how to use the ListViewCommandEventArgs object that is passed to the event handler.
<%@ Page language="VB" %> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> <script runat="server"> Protected Sub EmployeesListView_OnItemCommand(ByVal sender As Object, _ ByVal e As ListViewCommandEventArgs) If String.Equals(e.CommandName, "AddToList") Then ' Verify that the employee ID is not already in the list. If not, add the ' employee to the list. Dim dataItem As ListViewDataItem = CType(e.Item, ListViewDataItem) Dim employeeID As String = _ EmployeesListView.DataKeys(dataItem.DisplayIndex).Value.ToString() If SelectedEmployeesListBox.Items.FindByValue(employeeID) Is Nothing Then Dim item As ListItem = _ New ListItem(e.CommandArgument.ToString(), employeeID) SelectedEmployeesListBox.Items.Add(item) End If End If End Sub </script> <html xmlns="http://www.w3.org/1999/xhtml" > <head id="Head2" runat="server"> <title>Employee List</title> </head> <body> <form id="form1" runat="server"> <asp:ListView runat="server" ID="EmployeesListView" OnItemCommand="EmployeesListView_OnItemCommand" DataSourceID="EmployeesDataSource" DataKeyNames="EmployeeID"> <LayoutTemplate> <table runat="server" id="tblEmployees" cellspacing="0" cellpadding="1" width="440px" border="1"> <tr id="itemPlaceholder" runat="server"></tr> </table> <asp:DataPager ID="EmployeesDataPager" runat="server" PageSize="10"> <Fields> <asp:NumericPagerField /> </Fields> </asp:DataPager> </LayoutTemplate> <ItemTemplate> <tr runat="server"> <td> <asp:Label runat="server" ID="NameLabel" Text='<%#Eval("LastName") & ", " & Eval("FirstName") %>' /> </td> <td style="width:80px"> <asp:LinkButton runat="server" ID="SelectEmployeeButton" Text="Add To List" CommandName="AddToList" CommandArgument='<%#Eval("LastName") & ", " & Eval("FirstName") %>' /> </td> </tr> </ItemTemplate> </asp:ListView> <br /><br /> <b>Selected Employees:</b><br /> <asp:ListBox runat="server" ID="SelectedEmployeesListBox" Rows="10" Width="300px" /> <!-- This example uses Microsoft SQL Server and connects --> <!-- to the AdventureWorks sample database. Use an ASP.NET --> <!-- expression to retrieve the connection string value --> <!-- from the Web.config file. --> <asp:SqlDataSource ID="EmployeesDataSource" runat="server" ConnectionString="<%$ ConnectionStrings:AdventureWorks_DataConnectionString %>" SelectCommand="SELECT [EmployeeID], [FirstName], [LastName] FROM HumanResources.vEmployee ORDER BY [LastName], [FirstName], [EmployeeID]"> </asp:SqlDataSource> </form> </body> </html>
Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2
The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.
