Microsoft.com
Bienvenido Iniciar sesión
Inicio de .NET Framework
Clásica  |   Ligera  |   ScriptFree
Evaluar y enviar comentarios
Contraer todo/Expandir todo Contraer todo
Esta página es específica de
Microsoft Visual Studio 2010/.NET Framework 4

Hay además otras versiones disponibles para:
Biblioteca de clases de .NET Framework
ImageButton (Clase)

Control que muestra una imagen y responde a los clics del mouse en la imagen.

 Jerarquía de herencia
System..::.Object
  System.Web.UI..::.Control
    System.Web.UI.WebControls..::.WebControl
      System.Web.UI.WebControls..::.Image
        System.Web.UI.WebControls..::.ImageButton

Espacio de nombres:  System.Web.UI.WebControls
Ensamblado:  System.Web (en System.Web.dll)
 Sintaxis
Visual Basic 
Public Class ImageButton _
    Inherits Image _
    Implements IPostBackDataHandler, IPostBackEventHandler, IButtonControl
C# 
public class ImageButton : Image, 
    IPostBackDataHandler, IPostBackEventHandler, IButtonControl
Visual C++ 
public ref class ImageButton : public Image, 
    IPostBackDataHandler, IPostBackEventHandler, IButtonControl
F# 
type ImageButton =  
    class
        inherit Image
        interface IPostBackDataHandler
        interface IPostBackEventHandler
        interface IButtonControl
    end
ASP.NET 
<asp:ImageButton />

El tipo ImageButton expone los siguientes miembros.

 Constructores
  NombreDescripción
Método públicoImageButtonInicializa una nueva instancia de la clase ImageButton.
Arriba
 Propiedades
  NombreDescripción
Propiedad públicaAccessKeyObtiene o establece la clave de acceso que permite navegar rápidamente al control de servidor web. (Se hereda de WebControl).
Propiedad protegidaAdapterObtiene el adaptador específico del explorador para el control. (Se hereda de Control).
Propiedad públicaAlternateTextObtiene o establece el texto alternativo que se muestra en el control Image cuando no está disponible la imagen. Los exploradores que admiten la característica de información sobre herramientas muestran este texto como una información sobre herramientas. (Se hereda de Image).
Propiedad públicaAppRelativeTemplateSourceDirectoryObtiene o establece el directorio virtual relativo a la aplicación del objeto Page o el objeto UserControl que contiene este control. (Se hereda de Control).
Propiedad públicaAttributesObtiene la colección de atributos arbitrarios (sólo para su representación) que no corresponden a propiedades del control. (Se hereda de WebControl).
Propiedad públicaBackColorObtiene o establece el color de fondo del control de servidor web. (Se hereda de WebControl).
Propiedad públicaBindingContainerInfraestructura. Obtiene el control que contiene el enlace de datos de este control. (Se hereda de Control).
Propiedad públicaBorderColorObtiene o establece el color de borde del control Web. (Se hereda de WebControl).
Propiedad públicaBorderStyleObtiene o establece el estilo del borde del control de servidor web. (Se hereda de WebControl).
Propiedad públicaBorderWidthObtiene o establece el ancho del borde del control de servidor web. (Se hereda de WebControl).
Propiedad públicaCausesValidationObtiene o establece un valor que indica si la validación se realiza al hacer clic en el control ImageButton.
Propiedad protegidaChildControlsCreatedObtiene un valor que indica si se han creado controles secundarios del control de servidor. (Se hereda de Control).
Propiedad públicaClientIDObtiene el identificador de control del formato HTML generado por ASP.NET. (Se hereda de Control).
Propiedad públicaClientIDModeObtiene o establece el algoritmo que se utiliza para generar el valor de la propiedad ClientID. (Se hereda de Control).
Propiedad protegidaClientIDSeparatorObtiene un valor de carácter que representa el carácter separado utilizado en la propiedad ClientID. (Se hereda de Control).
Propiedad públicaCommandArgumentObtiene o establece un argumento opcional que facilita información adicional sobre la propiedad CommandName.
Propiedad públicaCommandNameObtiene o establece el nombre de comando asociado al control ImageButton.
Propiedad protegidaContextObtiene el objeto HttpContext asociado al control de servidor para la solicitud Web actual. (Se hereda de Control).
Propiedad públicaControlsObtiene un objeto ControlCollection que representa los controles secundarios para un control de servidor especificado en la jerarquía de la interfaz de usuario. (Se hereda de Control).
Propiedad públicaControlStyleObtiene el estilo del control de servidor web. Esta propiedad la usan principalmente los programadores de controles. (Se hereda de WebControl).
Propiedad públicaControlStyleCreatedObtiene un valor que indica si se ha creado un objeto Style para la propiedad ControlStyle. Esta propiedad la usan principalmente los programadores de controles. (Se hereda de WebControl).
Propiedad públicaCssClassObtiene o establece la clase hoja de estilo en cascada (CSS) presentada por el control de servidor web en el cliente. (Se hereda de WebControl).
Propiedad públicaDataItemContainerObtiene una referencia al contenedor de nomenclatura si este implementa IDataItemContainer. (Se hereda de Control).
Propiedad públicaDataKeysContainerObtiene una referencia al contenedor de nomenclatura si este implementa IDataKeysControl. (Se hereda de Control).
Propiedad públicaDescriptionUrlObtiene o establece la ubicación en una descripción detallada para la imagen. (Se hereda de Image).
Propiedad protegidaDesignModeObtiene un valor que indica si se está utilizando un control en una superficie de diseño. (Se hereda de Control).
Propiedad públicaEnabledObtiene o establece un valor que indica si se puede hacer clic en el control ImageButton para devolver datos al servidor. (Invalida a Image..::.Enabled).
Propiedad públicaEnableThemingObtiene o establece un valor que indica si los temas se aplican a este control. (Se hereda de WebControl).
Propiedad públicaEnableViewStateObtiene o establece un valor que indica si el control de servidor debe mantener su estado de vista y el de los controles secundarios que contiene, en el cliente que realiza la solicitud. (Se hereda de Control).
Propiedad protegidaEventsObtiene una lista de delegados de controladores de eventos del control. Esta propiedad es de sólo lectura. (Se hereda de Control).
Propiedad públicaFontObtiene las propiedades de fuente para el texto asociado al control. (Se hereda de Image).
Propiedad públicaForeColorObtiene o establece el color de primer plano (normalmente el color del texto) del control de servidor web. (Se hereda de WebControl).
Propiedad públicaGenerateEmptyAlternateTextObtiene o establece un valor que indica si el control genera un atributo de texto alternativo para un valor de cadena vacía. (Invalida a Image..::.GenerateEmptyAlternateText).
Propiedad públicaHasAttributesObtiene un valor que indica si el control tiene establecido algún atributo. (Se hereda de WebControl).
Propiedad protegidaHasChildViewStateObtiene un valor que indica si los controles secundarios del control de servidor actual tienen guardada alguna configuración del estado de vista. (Se hereda de Control).
Propiedad públicaHeightObtiene o establece el alto del control de servidor Web. (Se hereda de WebControl).
Propiedad públicaIDObtiene o establece el identificador de programación asignado al control de servidor. (Se hereda de Control).
Propiedad protegidaIdSeparatorInfraestructura. Obtiene el carácter utilizado para separar los identificadores de control. (Se hereda de Control).
Propiedad públicaImageAlignObtiene o establece la alineación del control Image con respecto a otros elementos de la página Web. (Se hereda de Image).
Propiedad públicaImageUrlObtiene o establece la dirección URL que proporciona la ruta de acceso a una imagen que se va a mostrar en un control Image. (Se hereda de Image).
Propiedad protegidaIsChildControlStateClearedObtiene un valor que indica si los controles que se encuentran en este control tienen estado de control. (Se hereda de Control).
Propiedad protegidaIsEnabledObtiene un valor que indica si está habilitado el control. (Se hereda de WebControl).
Propiedad protegidaIsTrackingViewStateObtiene un valor que indica si el control de servidor está guardando los cambios realizados en su estado de vista. (Se hereda de Control).
Propiedad protegidaIsViewStateEnabledObtiene un valor que indica si el estado de vista está habilitado para este control. (Se hereda de Control).
Propiedad protegidaLoadViewStateByIDObtiene un valor que indica si el control participa en la carga de su estado de vista mediante ID en lugar de índice. (Se hereda de Control).
Propiedad públicaNamingContainerObtiene una referencia al contenedor de nomenclatura del control de servidor, que crea un espacio de nombres único para diferenciar los distintos controles de servidor que tienen el mismo valor para la propiedad Control..::.ID. (Se hereda de Control).
Propiedad públicaOnClientClickObtiene o establece el script de cliente que se ejecuta cuando se genera un evento Click de un control ImageButton.
Propiedad públicaPageObtiene una referencia a la instancia Page que contiene el control de servidor. (Se hereda de Control).
Propiedad públicaParentObtiene una referencia al control principal del control de servidor en la jerarquía de controles de página. (Se hereda de Control).
Propiedad públicaPostBackUrlObtiene o establece la dirección URL de la página de destino del envío desde la página actual cuando se hace clic en el control ImageButton.
Propiedad públicaRenderingCompatibilityObtiene o establece un valor que especifica la versión de ASP.NET compatible con los elementos HTML representados. (Se hereda de Control).
Propiedad públicaSiteObtiene información sobre el contenedor en que se encuentra el control actual cuando se representa en una superficie de diseño. (Se hereda de Control).
Propiedad públicaSkinIDObtiene o establece la máscara que se va a aplicar al control. (Se hereda de WebControl).
Propiedad públicaStyleObtiene una colección de atributos de texto que se representan como atributo de estilo en la etiqueta externa del control de servidor web. (Se hereda de WebControl).
Propiedad públicaSupportsDisabledAttributeObtiene un valor que indica si el control debe establecer en "disabled" el atributo disabled del elemento HTML presentado cuando el valor de la propiedad IsEnabled del control es false. (Invalida a Image..::.SupportsDisabledAttribute).
Propiedad públicaTabIndexObtiene o establece el índice de tabulación del control de servidor web. (Se hereda de WebControl).
Propiedad protegidaTagKeyObtiene el valor de HtmlTextWriterTag correspondiente al control ImageButton. (Invalida a WebControl..::.TagKey).
Propiedad protegidaTagNameObtiene el nombre de la etiqueta del control. Esta propiedad la usan principalmente los programadores de controles. (Se hereda de WebControl).
Propiedad públicaTemplateControlObtiene o establece una referencia a la plantilla que contiene este control. (Se hereda de Control).
Propiedad públicaTemplateSourceDirectoryObtiene el directorio virtual de Page o UserControl que contiene el control de servidor actual. (Se hereda de Control).
Propiedad protegidaTextInfraestructura. Obtiene o establece el valor de la propiedad AlternateText del control ImageButton.
Propiedad públicaToolTipObtiene o establece el texto que se muestra cuando el puntero del mouse se desplaza sobre el control de servidor web. (Se hereda de WebControl).
Propiedad públicaUniqueIDObtiene el identificador único calificado jerárquicamente para el control de servidor. (Se hereda de Control).
Propiedad públicaValidationGroupObtiene o establece el grupo de controles para los que el control ImageButton ejecuta una validación cuando devuelve datos al servidor.
Propiedad protegidaViewStateObtiene un diccionario con información de estado que le permite guardar y restaurar el estado de vista de un control de servidor en las distintas solicitudes de la misma página. (Se hereda de Control).
Propiedad protegidaViewStateIgnoresCaseObtiene un valor que indica si el objeto StateBag no distingue mayúsculas de minúsculas. (Se hereda de Control).
Propiedad públicaViewStateModeObtiene o establece el modo del estado de vista de este control. (Se hereda de Control).
Propiedad públicaVisibleObtiene o establece un valor que indica si un control de servidor se debe representar como interfaz de usuario en la página. (Se hereda de Control).
Propiedad públicaWidthObtiene o establece el ancho del control de servidor web. (Se hereda de WebControl).
Arriba
 Métodos
  NombreDescripción
Método protegidoAddAttributesToRenderAgrega los atributos de la clase ImageButton al flujo de salida para su representación en el cliente. (Invalida a Image..::.AddAttributesToRender(HtmlTextWriter)).
Método protegidoAddedControlSe le llama una vez que se ha agregado un control secundario a la colección Controls del Control objeto. (Se hereda de Control).
Método protegidoAddParsedSubObjectIndica al control de servidor que se ha analizado un elemento, ya sea XML o HTML, y agrega dicho elemento al objeto ControlCollection del control de servidor. (Se hereda de Control).
Método públicoApplyStyleCopia en el control Web todos los elementos no vacíos del estilo especificado, sobrescribiendo los elementos de estilo existentes del mismo. Este método lo usan principalmente los programadores de controles. (Se hereda de WebControl).
Método públicoApplyStyleSheetSkinAplica al control las propiedades de estilo definidas en la hoja de estilos de la página. (Se hereda de Control).
Método protegidoBuildProfileTreeInfraestructura. Recopila información sobre el control de servidor y la pasa a la propiedad Trace para que se muestre cuando está habilitada la traza de la página. (Se hereda de Control).
Método protegidoClearCachedClientIDInfraestructura. Establece en nullNothingnullptrreferencia null (Nothing en Visual Basic) el valor de ClientID almacenado en caché. (Se hereda de Control).
Método protegidoClearChildControlStateElimina la información sobre el estado de control de los controles secundarios del control de servidor. (Se hereda de Control).
Método protegidoClearChildStateElimina la información sobre el estado de vista y el estado de control de los controles secundarios del control de servidor. (Se hereda de Control).
Método protegidoClearChildViewStateElimina la información sobre el estado de vista de todos los controles secundarios del control de servidor. (Se hereda de Control).
Método protegidoClearEffectiveClientIDModeInfraestructura. Establece la propiedad ClientIDMode de la instancia del control actual y de cualquier control secundario en Inherit. (Se hereda de Control).
Método públicoCopyBaseAttributesCopia las propiedades no encapsuladas por el objeto Style del control de servidor web especificado al control de servidor web desde el que se efectúa la llamada al método. Este método lo usan principalmente los programadores de controles. (Se hereda de WebControl).
Método protegidoCreateChildControlsLo llama el marco de trabajo de las páginas ASP.NET para indicar a los controles de servidor que utilizan la implementación basada en la composición que creen los controles secundarios que contengan como forma de preparar la devolución o representación de los datos. (Se hereda de Control).
Método protegidoCreateControlCollectionCrea un nuevo objeto ControlCollection para guardar los controles secundarios (tanto literales como de servidor) del control de servidor. (Se hereda de Control).
Método protegidoCreateControlStyleCrea el objeto de estilo que utiliza la clase WebControl de forma interna para implementar todas las propiedades relacionadas con el estilo. Este método lo usan principalmente los programadores de controles. (Se hereda de WebControl).
Método públicoDataBind()()()Enlaza un origen de datos al control de servidor invocado y a todos sus controles secundarios. (Se hereda de Control).
Método protegidoDataBind(Boolean)Enlaza un origen de datos al control de servidor que se ha invocado y a todos sus controles secundarios con una opción para generar el evento DataBinding. (Se hereda de Control).
Método protegidoDataBindChildrenEnlaza un origen de datos a los controles secundarios del control de servidor. (Se hereda de Control).
Método públicoDisposeHabilita un control de servidor para que realice la limpieza final antes de que se libere de la memoria. (Se hereda de Control).
Método protegidoEnsureChildControlsDetermina si el control de servidor contiene controles secundarios. Si no tiene controles secundarios, los crea. (Se hereda de Control).
Método protegidoEnsureIDCrea un identificador para controles que no tiene un identificador asignado. (Se hereda de Control).
Método públicoEquals(Object)Determina si el objeto Object especificado es igual al objeto Object actual. (Se hereda de Object).
Método protegidoFinalizePermite que un objeto intente liberar recursos y realizar otras operaciones de limpieza antes de ser reclamado por la recolección de elementos no utilizados. (Se hereda de Object).
Método públicoFindControl(String)Busca un control de servidor con el parámetro id especificado en el contenedor de nomenclatura actual. (Se hereda de Control).
Método protegidoFindControl(String, Int32)Infraestructura. Busca el contenedor de nomenclatura actual para un control de servidor con el id especificado y un entero, que se especifica en el parámetro pathOffset, que ayuda a realizar la búsqueda. Esta versión del método FindControl no se debe reemplazar. (Se hereda de Control).
Método públicoFocusEstablece el foco de entrada en un control. (Se hereda de Control).
Método protegidoGetDesignModeStateInfraestructura. Obtiene datos en tiempo de diseño para un control. (Se hereda de Control).
Método públicoGetHashCodeActúa como función hash para un tipo concreto. (Se hereda de Object).
Método protegidoGetPostBackOptionsCrea un objeto PostBackOptions que representa el comportamiento de la devolución de datos del control ImageButton.
Método públicoGetRouteUrl(Object)Obtiene la dirección URL que corresponde a un conjunto de parámetros de ruta. (Se hereda de Control).
Método públicoGetRouteUrl(RouteValueDictionary)Obtiene la dirección URL que corresponde a un conjunto de parámetros de ruta. (Se hereda de Control).
Método públicoGetRouteUrl(String, Object)Obtiene la dirección URL que corresponde a un conjunto de parámetros de ruta y un nombre de ruta. (Se hereda de Control).
Método públicoGetRouteUrl(String, RouteValueDictionary)Obtiene la dirección URL que corresponde a un conjunto de parámetros de ruta y un nombre de ruta. (Se hereda de Control).
Método públicoGetTypeObtiene el objeto Type de la instancia actual. (Se hereda de Object).
Método públicoGetUniqueIDRelativeToDevuelve la parte correspondiente al prefijo de la propiedad UniqueID del control especificado. (Se hereda de Control).
Método públicoHasControlsDetermina si el control de servidor contiene controles secundarios. (Se hereda de Control).
Método protegidoHasEventsDevuelve un valor que indica si se registran eventos para el control o los controles secundarios. (Se hereda de Control).
Método protegidoIsLiteralContentInfraestructura. Determina si el control de servidor alberga únicamente contenido literal. (Se hereda de Control).
Método protegidoLoadControlStateRestaura información de estado de control de una solicitud de página anterior guardada por el método SaveControlState. (Se hereda de Control).
Método protegidoLoadPostDataProcesa los datos enviados para el control ImageButton.
Método protegidoLoadViewStateRestaura la información de estado de vista de una solicitud anterior guardada con el método SaveViewState. (Se hereda de WebControl).
Método protegidoMapPathSecureRecupera la ruta de acceso física a la que se asigna una ruta de acceso virtual, absoluta o relativa. (Se hereda de Control).
Método protegidoMemberwiseCloneCrea una copia superficial del objeto Object actual. (Se hereda de Object).
Método públicoMergeStyleCopia en el control Web todos los elementos no vacíos del estilo especificado, pero no sobrescribe los elementos de estilo existentes en el mismo. Este método lo usan principalmente los programadores de controles. (Se hereda de WebControl).
Método protegidoOnBubbleEventDetermina si el evento del control de servidor debe pasarse a la jerarquía de controles de servidor de la interfaz de usuario de la página. (Se hereda de Control).
Método protegidoOnClickProvoca el evento Click y permite controlar directamente el evento Click.
Método protegidoOnCommandProvoca el evento Command y permite controlar directamente el evento Command.
Método protegidoOnDataBindingProvoca el evento DataBinding. (Se hereda de Control).
Método protegidoOnInitProvoca el evento Init. (Se hereda de Control).
Método protegidoOnLoadProvoca el evento Load. (Se hereda de Control).
Método protegidoOnPreRenderDetermina si se ha hecho clic en la imagen antes de representarla en el cliente. (Invalida a Control..::.OnPreRender(EventArgs)).
Método protegidoOnUnloadProvoca el evento Unload. (Se hereda de Control).
Método protegidoOpenFileObtiene un objeto Stream utilizado para leer un archivo. (Se hereda de Control).
Método protegidoRaiseBubbleEventAsigna los orígenes del evento y su información al control principal del control. (Se hereda de Control).
Método protegidoRaisePostBackEventProvoca los eventos para el control ImageButton cuando devuelve datos al servidor.
Método protegidoRaisePostDataChangedEventNotifica a la aplicación de ASP.NET que el estado del control ImageButton ha cambiado.
Método protegidoRemovedControlSe le llama una vez que se ha quitado un control secundario de la colección Controls del Control objeto. (Se hereda de Control).
Método protegidoRenderPresenta el control en el sistema de escritura HTML especificado. (Se hereda de WebControl).
Método públicoRenderBeginTagPresenta la etiqueta HTML de apertura del control en el sistema de escritura especificado. Este método lo usan principalmente los programadores de controles. (Se hereda de WebControl).
Método protegidoRenderChildrenEnvía el contenido del control secundario del control de servidor a un objeto HtmlTextWriter suministrado, que escribe el contenido que se va a representar en el cliente. (Se hereda de Control).
Método protegidoRenderContentsRepresenta el contenido del control de imagen en el escritor especificado. (Se hereda de Image).
Método públicoRenderControl(HtmlTextWriter)Envía el contenido del control de servidor a un objeto HtmlTextWriter que se proporciona y almacena la información de traza sobre el control si dicha traza está habilitada. (Se hereda de Control).
Método protegidoRenderControl(HtmlTextWriter, ControlAdapter)Coloca el contenido de un control de servidor en un objeto HtmlTextWriter proporcionado, utilizando un objeto ControlAdapter proporcionado. (Se hereda de Control).
Método públicoRenderEndTagPresenta la etiqueta HTML de cierre del control en el escritor especificado. Este método lo usan principalmente los programadores de controles. (Se hereda de WebControl).
Método protegidoResolveAdapterObtiene el adaptador de controles que se encarga de representar el control especificado. (Se hereda de Control).
Método públicoResolveClientUrlObtiene una dirección URL que el explorador puede utilizar. (Se hereda de Control).
Método públicoResolveUrlConvierte una dirección URL en una que el cliente solicitante pueda utilizar. (Se hereda de Control).
Método protegidoSaveControlStateGuarda los cambios de estado de un control de servidor que se hayan producido desde el momento en que se devolvieron al servidor los datos de la página. (Se hereda de Control).
Método protegidoSaveViewStateGuarda cualquier estado modificado después de invocar el método TrackViewState. (Se hereda de WebControl).
Método protegidoSetDesignModeStateEstablece datos en tiempo de diseño para un control. (Se hereda de Control).
Método públicoSetRenderMethodDelegateInfraestructura. Asigna un delegado de controlador de eventos para representar el control de servidor y su contenido en el control principal. (Se hereda de Control).
Método públicoToStringDevuelve una cadena que representa el objeto actual. (Se hereda de Object).
Método protegidoTrackViewStateHace que el control efectúe un seguimiento de los cambios de su estado de vista para que se puedan almacenar en la propiedad ViewState del objeto. (Se hereda de WebControl).
Arriba
 Eventos
  NombreDescripción
Evento públicoClickSe produce cuando se hace clic en el control ImageButton.
Evento públicoCommandSe produce cuando se hace clic en el control ImageButton.
Evento públicoDataBindingSe produce cuando el control de servidor se enlaza a un origen de datos. (Se hereda de Control).
Evento públicoDisposedSe produce cuando un control de servidor se libera de la memoria, lo que constituye la última fase del período de duración de un control de servidor cuando se solicita una página ASP.NET. (Se hereda de Control).
Evento públicoInitTiene lugar al inicializar el control de servidor, que es el primer paso en su ciclo de vida. (Se hereda de Control).
Evento públicoLoadSe produce cuando el control de servidor se carga en el objeto Page. (Se hereda de Control).
Evento públicoPreRenderSe produce una vez que se carga el objeto Control, pero antes de su representación. (Se hereda de Control).
Evento públicoUnloadSe produce cuando el control de servidor se descarga de la memoria. (Se hereda de Control).
Arriba
 Métodos de extensión
  NombreDescripción
Método de extensión públicoFindDataSourceControlDevuelve el origen de datos que está asociado al control de datos del control especificado. (Definido por DynamicDataExtensions).
Método de extensión públicoFindFieldTemplateDevuelve la plantilla de campo para la columna especificada en el contenedor de nomenclatura del control especificado. (Definido por DynamicDataExtensions).
Método de extensión públicoFindMetaTableDevuelve el objeto de metatabla para el control de datos contenedor. (Definido por DynamicDataExtensions).
Arriba
 Implementaciones explícitas de interfaces
  NombreDescripción
Implementación explícita de interfacesMétodo privadoIAttributeAccessor..::.GetAttributeInfraestructura. Obtiene un atributo del control Web con el nombre especificado. (Se hereda de WebControl).
Implementación explícita de interfacesMétodo privadoIAttributeAccessor..::.SetAttributeEstablece un atributo del control Web con el nombre y el valor especificados. (Se hereda de WebControl).
Implementación explícita de interfacesEvento privadoIButtonControl..::.ClickInfraestructura. Para obtener una descripción de este miembro, vea el evento IButtonControl..::.Click.
Implementación explícita de interfacesPropiedad privadaIButtonControl..::.TextInfraestructura. Para obtener una descripción de este miembro, vea IButtonControl..::.Text.
Implementación explícita de interfacesPropiedad privadaIControlBuilderAccessor..::.ControlBuilderPara obtener una descripción de este miembro, vea IControlBuilderAccessor..::.ControlBuilder. (Se hereda de Control).
Implementación explícita de interfacesMétodo privadoIControlDesignerAccessor..::.GetDesignModeStatePara obtener una descripción de este miembro, vea IControlDesignerAccessor..::.GetDesignModeState. (Se hereda de Control).
Implementación explícita de interfacesMétodo privadoIControlDesignerAccessor..::.SetDesignModeStatePara obtener una descripción de este miembro, vea IControlDesignerAccessor..::.SetDesignModeState. (Se hereda de Control).
Implementación explícita de interfacesMétodo privadoIControlDesignerAccessor..::.SetOwnerControlInfraestructura. Para obtener una descripción de este miembro, vea IControlDesignerAccessor..::.SetOwnerControl. (Se hereda de Control).
Implementación explícita de interfacesPropiedad privadaIControlDesignerAccessor..::.UserDataPara obtener una descripción de este miembro, vea IControlDesignerAccessor..::.UserData. (Se hereda de Control).
Implementación explícita de interfacesPropiedad privadaIDataBindingsAccessor..::.DataBindingsPara obtener una descripción de este miembro, vea IDataBindingsAccessor..::.DataBindings. (Se hereda de Control).
Implementación explícita de interfacesPropiedad privadaIDataBindingsAccessor..::.HasDataBindingsPara obtener una descripción de este miembro, vea IDataBindingsAccessor..::.HasDataBindings. (Se hereda de Control).
Implementación explícita de interfacesPropiedad privadaIExpressionsAccessor..::.ExpressionsPara obtener una descripción de este miembro, vea IExpressionsAccessor..::.Expressions. (Se hereda de Control).
Implementación explícita de interfacesPropiedad privadaIExpressionsAccessor..::.HasExpressionsPara obtener una descripción de este miembro, vea IExpressionsAccessor..::.HasExpressions. (Se hereda de Control).
Implementación explícita de interfacesMétodo privadoIParserAccessor..::.AddParsedSubObjectPara obtener una descripción de este miembro, vea IParserAccessor..::.AddParsedSubObject. (Se hereda de Control).
Implementación explícita de interfacesMétodo privadoIPostBackDataHandler..::.LoadPostDataInfraestructura. Para obtener una descripción de este miembro, vea IPostBackDataHandler..::.LoadPostData.
Implementación explícita de interfacesMétodo privadoIPostBackDataHandler..::.RaisePostDataChangedEventInfraestructura. Para obtener una descripción de este miembro, vea IPostBackDataHandler..::.RaisePostDataChangedEvent.
Implementación explícita de interfacesMétodo privadoIPostBackEventHandler..::.RaisePostBackEventInfraestructura. Para obtener una descripción de este miembro, vea IPostBackEventHandler..::.RaisePostBackEvent.
Arriba
 Comentarios

En este tema:

Introduction

Utilice el control ImageButton para mostrar una imagen que responde a los clics del mouse.

Se provocan los eventos Click y Command cuando se hace clic en el control ImageButton.

Se puede utilizar 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 misma página Web. A continuación, se puede identificar mediante programación el valor de la propiedad CommandName 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, como el orden ascendente.

Usar el control ImageButton es similar a usar el control Button ASP.NET. Para obtener más información, vea Mapa de contenido de los controles de botón de servidor web. y la información general sobre la clase para el control Button.

Determinar dónde hizo clic el usuario

Con ayuda del controlador de eventos OnClick, se pueden determinar mediante programación las coordenadas del punto donde se ha hecho clic en la imagen. A continuación, se puede crear código de respuesta tomando como base los valores de las coordenadas. Observe que el origen (0, 0) está situado en la esquina superior izquierda de la imagen.

Controles y validación de ImageButton

De manera predeterminada, se realiza la validación de la página cuando se hace clic en un control ImageButton. La validación de la página determina si todos los controles de entrada asociados a un control de validación en la página cumplen las reglas de validación especificadas por el control de validación. Para evitar que se realice la validación de la página, establezca la propiedad CausesValidation en false.

Accesibilidad

Para obtener información sobre cómo configurar este control para que genere un marcado que cumpla las normas de accesibilidad, vea Accesibilidad en Visual Studio y ASP.NET y Controles y accesibilidad en ASP.NET.

Sintaxis de la declaración

<asp:ImageButton
    AccessKey="string"
    AlternateText="string"
    BackColor="color name|#dddddd"
    BorderColor="color name|#dddddd"
    BorderStyle="NotSet|None|Dotted|Dashed|Solid|Double|Groove|Ridge|
        Inset|Outset"
    BorderWidth="size"
    CausesValidation="True|False"
    CommandArgument="string"
    CommandName="string"
    CssClass="string"
    DescriptionUrl="uri"
    Enabled="True|False"
    EnableTheming="True|False"
    EnableViewState="True|False"
    ForeColor="color name|#dddddd"
    Height="size"
    ID="string"
    ImageAlign="NotSet|Left|Right|Baseline|Top|Middle|Bottom|
        AbsBottom|AbsMiddle|TextTop"
    ImageUrl="uri"
    OnClick="Click event handler"
    OnClientClick="string"
    OnCommand="Command event handler"
    OnDataBinding="DataBinding event handler"
    OnDisposed="Disposed event handler"
    OnInit="Init event handler"
    OnLoad="Load event handler"
    OnPreRender="PreRender event handler"
    OnUnload="Unload event handler"
    PostBackUrl="uri"
    runat="server"
    SkinID="string"
    Style="string"
    TabIndex="integer"
    ToolTip="string"
    ValidationGroup="string"
    Visible="True|False"
    Width="size"
/>
TopicLocation
Cómo: Agregar controles Button de servidor Web a una página de formularios Web FormsGenerar aplicaciones Web ASP .NET
Cómo: Agregar controles Button de servidor Web a una página de formularios Web Forms (Visual Studio)Generar aplicaciones Web ASP .NET en Visual Studio
Cómo: Agregar controles Button de servidor Web a una página de formularios Web Forms (Visual Studio)Generar aplicaciones Web ASP .NET en Visual Studio
Cómo: Agregar controles ImageButton de servidor Web a una página de formularios Web FormsGenerar aplicaciones Web ASP .NET
Cómo: Agregar controles ImageButton de servidor Web a una página de formularios Web Forms (Visual Studio)Generar aplicaciones Web ASP .NET en Visual Studio
Cómo: Agregar controles ImageButton de servidor Web a una página de formularios Web Forms (Visual Studio)Generar aplicaciones Web ASP .NET en Visual Studio
Cómo: Agregar un botón de inicio de sesión a una página Web ASP.NETGenerar aplicaciones Web ASP .NET
Cómo: Agregar un botón de inicio de sesión a una página Web ASP.NETGenerar aplicaciones Web ASP .NET en Visual Studio
Cómo: Determinar las coordenadas de un control ImageButton de servidor WebGenerar aplicaciones Web ASP .NET
Cómo: Determinar las coordenadas de un control ImageButton de servidor WebGenerar aplicaciones Web ASP .NET en Visual Studio
Cómo: Establecer el foco en los controles de servidor Web ASP.NETGenerar aplicaciones Web ASP .NET
Cómo: Establecer el foco en los controles de servidor Web ASP.NETGenerar aplicaciones Web ASP .NET en Visual Studio
Cómo: Responder a eventos Button en controles enlazados a datosGenerar aplicaciones Web ASP .NET
Cómo: Responder a eventos Button en controles enlazados a datosGenerar aplicaciones Web ASP .NET en Visual Studio
Cómo: Responder a los eventos de botón en elementos DataList o RepeaterGenerar aplicaciones Web ASP .NET en Visual Studio
Cómo: Responder a los eventos de botón en elementos DataList, Repeater o GridViewGenerar aplicaciones Web ASP .NET
Cómo: Responder a los eventos de un control Button de servidor WebGenerar aplicaciones Web ASP .NET
Cómo: Responder a los eventos de un control Button de servidor WebGenerar aplicaciones Web ASP .NET en Visual Studio
Cómo: Responder a los eventos de un control Button de servidor Web en una secuencia de comandos del clienteGenerar aplicaciones Web ASP .NET
Cómo: Responder a los eventos de un control Button de servidor Web en una secuencia de comandos del clienteGenerar aplicaciones Web ASP .NET en Visual Studio
Tutorial: Crear y usar páginas principales ASP.NET en Visual Web DeveloperGenerar aplicaciones Web ASP .NET en Visual Studio
Tutorial: Crear y usar páginas principales ASP.NET en Visual Web DeveloperGenerar aplicaciones con Visual Web Developer
Tutorial: Enlace de datos a un objeto comercial personalizadoGenerar aplicaciones Web ASP .NET en Visual Studio
Tutorial: Enlace de datos a un objeto comercial personalizadoGenerar aplicaciones Web ASP .NET en Visual Studio
 Ejemplos

Hay un proyecto de sitio web de Visual Studio con código fuente disponible para este tema: Descargar.

En el ejemplo de código siguiente se muestra cómo crear un control ImageButton que muestra las coordenadas del punto donde se ha hecho clic en una imagen.

NotaNota

El siguiente ejemplo de código utiliza el modelo de código de un solo archivo y puede que no funcione correctamente si se copia directamente en un archivo de código subyacente. Se debe copiar este código de ejemplo en un archivo de texto vacío con una 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.

Visual Basic 
<%@ Page Language="VB" AutoEventWireup="True" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html  >
<head>
    <title>ImageButton Sample</title>
<script language="VB" runat="server">

      Sub ImageButton_Click(sender As Object, e As ImageClickEventArgs) 
         Label1.Text = "You clicked the ImageButton control at the coordinates: (" & _ 
                       e.X.ToString() & ", " & e.Y.ToString() & ")"
      End Sub

   </script>

</head>

<body>

   <form id="form1" runat="server">

      <h3>ImageButton Sample</h3>

      Click anywhere on the image.<br /><br />

      <asp:ImageButton id="imagebutton1" runat="server"
           AlternateText="ImageButton 1"
           ImageAlign="left"
           ImageUrl="images/pict.jpg"
           OnClick="ImageButton_Click"/>

      <br /><br />

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

   </form>

</body>
</html>
C# 
<%@ 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  >
<head>
    <title>ImageButton Sample</title>
<script language="C#" runat="server">

      void ImageButton_Click(object sender, ImageClickEventArgs e) 
      {
         Label1.Text = "You clicked the ImageButton control at the coordinates: (" + 
                       e.X.ToString() + ", " + e.Y.ToString() + ")";
      }

   </script>

</head>

<body>

   <form id="form1" runat="server">

      <h3>ImageButton Sample</h3>

      Click anywhere on the image.<br /><br />

      <asp:ImageButton id="imagebutton1" runat="server"
           AlternateText="ImageButton 1"
           ImageAlign="left"
           ImageUrl="images/pict.jpg"
           OnClick="ImageButton_Click"/>

      <br /><br />

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

   </form>

</body>
</html>
 Información de versión

.NET Framework

Compatible con: 4, 3.5, 3.0, 2.0, 1.1, 1.0
 Plataformas

Windows 7, Windows Vista SP1 o posterior, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (no se admite Server Core), Windows Server 2008 R2 (se admite Server Core con SP1 o posterior), Windows Server 2003 SP2

.NET Framework no admite todas las versiones de todas las plataformas. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.
 Seguridad para subprocesos
Todos los miembros static (Shared en Visual Basic) públicos de este tipo son seguros para la ejecución de subprocesos. No se garantiza que los miembros de instancias sean seguros para la ejecución de subprocesos.
 Vea también

Referencia

System.Web.UI.WebControls (Espacio de nombres)
Button
Image

Otros recursos

Mapa de contenido de los controles de botón de servidor web
Contenido de la comunidad   ¿Qué es Community Content?
Agregar contenido nuevo RSS  Anotaciones
© 2012 Microsoft. Reservados todos los derechos. Términos de uso | Marcas Registradas | Privacidad
Page view tracker