ListView.ItemCommand Händelse
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
Inträffar när en knapp i en ListView kontroll klickas.
public:
event EventHandler<System::Web::UI::WebControls::ListViewCommandEventArgs ^> ^ ItemCommand;public event EventHandler<System.Web.UI.WebControls.ListViewCommandEventArgs> ItemCommand;member this.ItemCommand : EventHandler<System.Web.UI.WebControls.ListViewCommandEventArgs> Public Custom Event ItemCommand As EventHandler(Of ListViewCommandEventArgs) Händelsetyp
Exempel
I följande exempel visas hur du skapar en ItemCommand händelsehanterare.
<%@ Page language="C#" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
protected void EmployeesListView_OnItemCommand(object sender, ListViewCommandEventArgs e)
{
if (String.Equals(e.CommandName, "AddToList"))
{
// Verify that the employee ID is not already in the list. If not, add the
// employee to the list.
ListViewDataItem dataItem = (ListViewDataItem)e.Item;
string employeeID =
EmployeesListView.DataKeys[dataItem.DisplayIndex].Value.ToString();
if (SelectedEmployeesListBox.Items.FindByValue(employeeID) == null)
{
ListItem item = new ListItem(e.CommandArgument.ToString(), employeeID);
SelectedEmployeesListBox.Items.Add(item);
}
}
}
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head1" 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>
<%@ 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>
Kommentarer
Händelsen ItemCommand aktiveras när en knapp i ListView kontrollen klickas. På så sätt kan du utföra en anpassad rutin när den här händelsen inträffar.
Knappar i en ListView kontroll kan också anropa inbyggda funktioner i kontrollen. I följande tabell visas värden som du kan använda med CommandName egenskapen för en knapp för att anropa inbyggda funktioner.
| CommandName-värde | Description |
|---|---|
| Avbryt | Avbryter en redigerings- eller infogningsåtgärd. Genererar händelsen ItemCanceling . |
| "Ta bort" | Tar bort den aktuella posten från datakällan. Genererar ItemDeleted händelserna och ItemDeleting . |
| "Välj" | SelectedIndex Anger egenskapen till egenskapsvärdet DisplayIndex för objektet. Renderar mallen SelectedItemTemplate för objektet. Genererar SelectedIndexChanging händelserna och SelectedIndexChanged . |
| Redigera | Placerar objektet i redigeringsläge. Renderar mallen EditItemTemplate för objektet. Genererar händelsen ItemEditing . |
| "Infoga" | Infogar de bundna värdena från mallen InsertItemTemplate i datakällan. Genererar ItemInserting händelserna och ItemInserted . |
| "Uppdatera" | Uppdaterar den aktuella posten i datakällan med de bundna värdena från mallen EditItemTemplate . Genererar ItemUpdating händelserna och ItemUpdated . |
| "Sortera" | Sorterar kolumnerna som anges i CommandArgument egenskapen för knappen. Genererar Sorting händelserna och Sorted . |
Händelsen ItemCommand aktiveras också när en knapp som visas i föregående tabell klickas. Vi rekommenderar dock att du använder händelserna som anges i tabellen. Händelsen ItemCommand används vanligtvis för att hantera anpassade åtgärder.
Ett ListViewCommandEventArgs objekt skickas till händelsehanteraren, vilket gör att du kan fastställa kommandonamnet och kommandoargumentet för knappen som klickades. Använd egenskapen för CommandEventArgs.CommandName att fastställa kommandonamnet. Använd egenskapen för att fastställa kommandoargumentet CommandEventArgs.CommandArgument . Om du vill komma åt kontrollen som skapade händelsen använder du ListViewCommandEventArgs.CommandSource egenskapen .
Mer information om hur du hanterar händelser finns i Hantera och höja händelser.
