This documentation is archived and is not being maintained.

ImageButton.Command Event

Occurs when the ImageButton is clicked.

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

public event CommandEventHandler Command
/** @event */
public final void add_Command (CommandEventHandler value)

/** @event */
public final void remove_Command (CommandEventHandler value)

JScript supports the use of events, but not the declaration of new ones.

The Command event is raised when an ImageButton control is clicked.


The Command event is raised through the control hierarchy in the form of the BubbleEvent.


This event causes the page to postback to the server.

For more information about handling events, see How to: Consume Events in a Web Forms Application.

The following example demonstrates how to specify and code a handler for the Command event to determine which ImageButton control is clicked.


The following code sample uses the single-file code model and may not work correctly if copied directly into a code-behind file. This code sample must be copied into an empty text file that has an .aspx extension. For more information on the Web Forms code model, see ASP.NET Web Page Code Model.

<%@ Page Language="C#" AutoEventWireup="True" %>

   <script language="C#" runat="server">

      void ImageButton_Command(object sender, CommandEventArgs e) 
         if (e.CommandName == "Sort" && e.CommandArgument == "Ascending")
            Label1.Text = "You clicked the Sort Ascending Button";
            Label1.Text = "You clicked the Sort Descending Button";




   <form runat="server">

      <h3>ImageButton CommandName Sample</h3>

      Click an image.<br><br>

      <asp:ImageButton id="imagebutton1" runat="server"
           AlternateText="Sort Ascending"

      <asp:ImageButton id="imagebutton2" runat="server"
           AlternateText="Sort Descending"

      <asp:label id="Label1" runat="server"/>



Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see System Requirements.

.NET Framework

Supported in: 2.0, 1.1, 1.0