ImageButton.OnCommand (Método)
Ensamblado: System.Web (en system.web.dll)
Se provoca el evento Command cuando se hace clic en el control ImageButton. Se utiliza el controlador de eventos OnCommand para que el control ImageButton se comporte como un botón de comando. Se puede asociar un nombre de comando al control mediante la propiedad CommandName. Esto permite colocar varios controles ImageButton en la página Web. A continuación, el valor de esta propiedad se puede identificar mediante programación en el controlador de eventos OnCommand para determinar la acción apropiada que debe realizarse cuando se hace clic en cada uno de los controles ImageButton. También puede utilizarse la propiedad CommandArgument para pasar más información sobre el comando, por ejemplo para especificar el orden ascendente.
 Nota: |
|---|
| El evento Command se provoca mediante la jerarquía de controles, con el formato de BubbleEvent. |
Cuando se provoca un evento, se invoca al controlador del evento por medio de un delegado. Para obtener más información, vea Cómo: Consumir eventos en una aplicación de formularios Web Forms.
El método OnCommand también permite que las clases derivadas controlen el evento sin asociar un delegado. Ésta es la técnica preferida para controlar eventos en una clase derivada.
Notas para los herederos: Al reemplazar OnCommand en una clase derivada, asegúrese de llamar al método OnCommand de la clase base para que los delegados registrados reciban el evento.En el siguiente ejemplo se muestra cómo especificar y crear código de controlador para el evento Command de modo que se determine en qué control ImageButton se ha hecho clic.
| Nota: |
|---|
| El ejemplo de código siguiente utiliza un modelo de código de un solo archivo y puede no funcionar correctamente si se copia directamente en un archivo con el código subyacente. Se debe copiar este ejemplo de código en un archivo de texto vacío con la extensión .aspx. Para obtener más información sobre el modelo de código de los formularios Web Forms, vea Modelo de código de las páginas Web ASP.NET. |
<%@ Page Language="C#" AutoEventWireup="True" %> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> <html xmlns="http://www.w3.org/1999/xhtml" > <head> <title>ImageButton CommandName Sample</title> <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"; else Label1.Text = "You clicked the Sort Descending Button"; } </script> </head> <body> <form id="form1" runat="server"> <h3>ImageButton CommandName Sample</h3> Click an image.<br /><br /> <asp:ImageButton id="imagebutton1" runat="server" AlternateText="Sort Ascending" ImageUrl="images/pict.jpg" OnCommand="ImageButton_Command" CommandName="Sort" CommandArgument="Ascending"/> <asp:ImageButton id="imagebutton2" runat="server" AlternateText="Sort Descending" ImageUrl="image/pict2.jpg" OnCommand="ImageButton_Command" CommandName="Sort" CommandArgument="Descending"/> <br /><br /> <asp:label id="Label1" runat="server"/> </form> </body> </html>
Windows 98, Windows 2000 Service Pack 4, Windows CE, Windows Millennium, Windows Mobile para Pocket PC, Windows Mobile para Smartphone, Windows Server 2003, Windows XP Media Center, Windows XP Professional x64, Windows XP SP2, Windows XP Starter
Microsoft .NET Framework 3.0 es compatible con Windows Vista, Microsoft Windows XP SP2 y Windows Server 2003 SP1.Referencia
ImageButton (Clase)ImageButton (Miembros)
System.Web.UI.WebControls (Espacio de nombres)
Command
CommandEventArgs
Otros recursos
Sintaxis declarativa del control de servidor Web ImageButtonInformación general sobre Button (Control de servidor Web)
Cómo: Consumir eventos en una aplicación de formularios Web Forms
