DetailsView.ItemCommand Event


Occurs when a button within a DetailsView control is clicked.

Namespace:   System.Web.UI.WebControls
Assembly:  System.Web (in System.Web.dll)

Public Event ItemCommand As DetailsViewCommandEventHandler

The ItemCommand event is raised when a button within the DetailsView control is clicked. This allows you to provide an event handler that performs a custom routine whenever this event occurs.

A DetailsViewCommandEventArgs object is passed to the event handler, which allows you to determine the command name and command argument of the button clicked. To determine the index of the current record, use the PageIndex property.

For more information about handling events, see NIB: Consuming Events.

The following code example demonstrates how to use the ItemCommand event to handle a button click in a DetailsView control. When the user clicks the Add Contact button, the item is added to a ListBox control.

<%@ Page Language="VB" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
<script runat="server">

  Sub CustomerDetailView_ItemCommand(ByVal sender As Object, ByVal e As DetailsViewCommandEventArgs)

        ' Use the CommandName property to determine which button
        ' was clicked. 
        If e.CommandName = "Add" Then

            ' Add the current store to the contact list. 

            ' Get the row that contains the store name. In this
            ' example, the store name is in the second row (index 1)  
            ' of the DetailsView control.
            Dim row As DetailsViewRow = CustomerDetailView.Rows(1)

            ' Get the store's name from the appropriate cell.
            ' In this example, the store name is in the second cell  
            ' (index 1) of the row.
            Dim name As String = row.Cells(1).Text

            ' Create a ListItem object with the store's name.
            Dim item As New ListItem(name)

            ' Add the ListItem object to the ListBox, if the 
            ' item doesn't already exist.
            If Not ContactListBox.Items.Contains(item) Then


            End If

        End If

    End Sub


<html xmlns="" >
<head runat="server">
            DetailsView ItemCommand Example</title>
    <form id="Form1" runat="server">
            DetailsView ItemCommand Example</h3>
        <asp:DetailsView ID="CustomerDetailView" 

            <FieldHeaderStyle BackColor="Navy" ForeColor="White" />

                <asp:BoundField DataField="CustomerID" HeaderText="Store ID" />
                <asp:BoundField DataField="CompanyName" HeaderText="Store Name" />
                <asp:BoundField DataField="City" HeaderText="City" />
                <asp:ButtonField CommandName="Add" Text="Add Contact" />

        <hr />

        Contacts:<br />
        <asp:ListBox ID="ContactListBox" runat="server" />
        <!-- This example uses Microsoft SQL Server and connects  -->
        <!-- to the Northwind sample database. Use an ASP.NET     -->
        <!-- expression to retrieve the connection string value   -->
        <!-- from the web.config file.                            -->
        <asp:SqlDataSource ID="DetailsViewSource" runat="server" 
            "<%$ ConnectionStrings:NorthWindConnectionString%>"
            InsertCommand="INSERT INTO [Customers]([CustomerID], [CompanyName], [Address], [City], [PostalCode], [Country]) VALUES (@CustomerID, @CompanyName, @Address, @City, @PostalCode, @Country)"
          SelectCommand="Select [CustomerID], [CompanyName], 
            [Address], [City], [PostalCode], [Country] From 

.NET Framework
Available since 2.0
Return to top