Este artículo se tradujo automáticamente. Para ver el artículo en inglés, active la casilla Inglés. Además, puede mostrar el texto en inglés en una ventana emergente si mueve el puntero del mouse sobre el texto.
Traducción
Inglés

Clase ImageButton

 

Publicado: octubre de 2016

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

Espacio de nombres:   System.Web.UI.WebControls
Ensamblado:  System.Web (en System.Web.dll)

System.Object
  System.Web.UI.Control
    System.Web.UI.WebControls.WebControl
      System.Web.UI.WebControls.Image
        System.Web.UI.WebControls.ImageButton

public class ImageButton : Image, IPostBackDataHandler, IPostBackEventHandler, 
	IButtonControl

NombreDescripción
System_CAPS_pubmethodImageButton()

Inicializa una nueva instancia de la clase ImageButton.

NombreDescripción
System_CAPS_pubpropertyAccessKey

Obtiene o establece la clave de acceso que permite navegar rápidamente al control de servidor Web.(Heredado de WebControl).

System_CAPS_protpropertyAdapter

Obtiene el adaptador específico del explorador para el control.(Heredado de Control).

System_CAPS_pubpropertyAlternateText

Obtiene o establece el texto alternativo que se muestra en el Image controlar cuándo 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.(Heredado de Image).

System_CAPS_pubpropertyAppRelativeTemplateSourceDirectory

Obtiene o establece el directorio virtual relativa a la aplicación de la Page o UserControl objeto que contiene este control.(Heredado de Control).

System_CAPS_pubpropertyAttributes

Obtiene la colección de atributos arbitrarios (sólo para representación) que no corresponden a propiedades del control.(Heredado de WebControl).

System_CAPS_pubpropertyBackColor

Obtiene o establece el color de fondo del control de servidor Web.(Heredado de WebControl).

System_CAPS_pubpropertyBindingContainer

Esta API admite la infraestructura producto y no está diseñada para usarse directamente desde el código. Obtiene el control que contiene el enlace de datos del control.(Heredado de Control).

System_CAPS_pubpropertyBorderColor

Obtiene o establece el color del borde del control Web.(Heredado de WebControl).

System_CAPS_pubpropertyBorderStyle

Obtiene o establece el estilo de borde del control de servidor Web.(Heredado de WebControl).

System_CAPS_pubpropertyBorderWidth

Obtiene o establece el ancho del borde del control de servidor Web.(Heredado de WebControl).

System_CAPS_pubpropertyCausesValidation

Obtiene o establece un valor que indica si la validación se realiza cuando el ImageButton se hace clic en el control.

System_CAPS_protpropertyChildControlsCreated

Obtiene un valor que indica si se crearon los controles secundarios del control de servidor.(Heredado de Control).

System_CAPS_pubpropertyClientID

Obtiene el id. de control para marcado HTML que se genera por ASP.NET.(Heredado de Control).

System_CAPS_pubpropertyClientIDMode

Obtiene o establece el algoritmo que se usa para generar el valor de la ClientID propiedad.(Heredado de Control).

System_CAPS_protpropertyClientIDSeparator

Obtiene un valor de carácter que representa el carácter separador utilizado en el ClientID propiedad.(Heredado de Control).

System_CAPS_pubpropertyCommandArgument

Obtiene o establece un argumento opcional que proporciona información adicional sobre el CommandName propiedad.

System_CAPS_pubpropertyCommandName

Obtiene o establece el nombre de comando asociado con el ImageButton control.

System_CAPS_protpropertyContext

Obtiene el HttpContext objeto asociado con el control de servidor para la solicitud Web actual.(Heredado de Control).

System_CAPS_pubpropertyControls

Obtiene un ControlCollection objeto que representa los controles secundarios de un control de servidor especificado en la jerarquía de la interfaz de usuario.(Heredado de Control).

System_CAPS_pubpropertyControlStyle

Obtiene el estilo del control de servidor Web. Esta propiedad la usan principalmente los programadores de controles.(Heredado de WebControl).

System_CAPS_pubpropertyControlStyleCreated

Obtiene un valor que indica si un Style se ha creado el objeto para el ControlStyle propiedad. Esta propiedad se utiliza principalmente los programadores de controles.(Heredado de WebControl).

System_CAPS_pubpropertyCssClass

Obtiene o establece la clase de hoja de estilos en cascada (CSS) representada por el control de servidor Web en el cliente.(Heredado de WebControl).

System_CAPS_pubpropertyDataItemContainer

Obtiene una referencia al contenedor de nomenclatura si implementa el contenedor de nomenclatura IDataItemContainer.(Heredado de Control).

System_CAPS_pubpropertyDataKeysContainer

Obtiene una referencia al contenedor de nomenclatura si implementa el contenedor de nomenclatura IDataKeysControl.(Heredado de Control).

System_CAPS_pubpropertyDescriptionUrl

Obtiene o establece la ubicación en una descripción detallada de la imagen.(Heredado de Image).

System_CAPS_protpropertyDesignMode

Obtiene un valor que indica si se está utilizando un control en una superficie de diseño.(Heredado de Control).

System_CAPS_pubpropertyEnabled

Obtiene o establece un valor que indica si la ImageButton puede hacer clic para realizar un envío al servidor.(Invalida Image.Enabled).

System_CAPS_pubpropertyEnableTheming

Obtiene o establece un valor que indica si se aplican temas a este control.(Heredado de WebControl).

System_CAPS_pubpropertyEnableViewState

Obtiene o establece un valor que indica si el control de servidor conserva su estado de vista, así como el estado de vista de los controles secundarios que contiene, al cliente solicitante.(Heredado de Control).

System_CAPS_protpropertyEvents

Obtiene una lista de delegados de controladores de eventos para el control. Esta propiedad es de sólo lectura.(Heredado de Control).

System_CAPS_pubpropertyFont

Obtiene las propiedades de fuente para el texto asociado al control.(Heredado de Image).

System_CAPS_pubpropertyForeColor

Obtiene o establece el color de primer plano (normalmente el color del texto) del control de servidor Web.(Heredado de WebControl).

System_CAPS_pubpropertyGenerateEmptyAlternateText

Obtiene o establece un valor que indica si el control genera un atributo de texto alternativo para un valor de cadena vacía.(Invalida Image.GenerateEmptyAlternateText).

System_CAPS_pubpropertyHasAttributes

Obtiene un valor que indica si el control tiene un atributo del conjunto.(Heredado de WebControl).

System_CAPS_protpropertyHasChildViewState

Obtiene un valor que indica si los controles secundarios del control de servidor actual tienen cualquier configuración de estado de vista guardado.(Heredado de Control).

System_CAPS_pubpropertyHeight

Obtiene o establece el alto del control de servidor Web.(Heredado de WebControl).

System_CAPS_pubpropertyID

Obtiene o establece el identificador de programación asignado al control de servidor.(Heredado de Control).

System_CAPS_protpropertyIdSeparator

Esta API admite la infraestructura producto y no está diseñada para usarse directamente desde el código. Obtiene el carácter utilizado para separar los identificadores de control.(Heredado de Control).

System_CAPS_pubpropertyImageAlign

Obtiene o establece la alineación de la Image control con respecto a otros elementos de la página Web.(Heredado de Image).

System_CAPS_pubpropertyImageUrl

Obtiene o establece la dirección URL que proporciona la ruta de acceso a una imagen para mostrar en el Image control.(Heredado de Image).

System_CAPS_protpropertyIsChildControlStateCleared

Obtiene un valor que indica si los controles incluidos en este control tienen estado de control.(Heredado de Control).

System_CAPS_protpropertyIsEnabled

Obtiene un valor que indica si el control está habilitado.(Heredado de WebControl).

System_CAPS_protpropertyIsTrackingViewState

Obtiene un valor que indica si el control de servidor está guardando los cambios en su estado de vista.(Heredado de Control).

System_CAPS_protpropertyIsViewStateEnabled

Obtiene un valor que indica si el estado de vista está habilitado para este control.(Heredado de Control).

System_CAPS_protpropertyLoadViewStateByID

Obtiene un valor que indica si el control participa en la carga su estado de vista por ID en lugar de índice.(Heredado de Control).

System_CAPS_pubpropertyNamingContainer

Obtiene una referencia al control de servidor de nombres del contenedor, que crea un espacio de nombres único para diferenciar los distintos controles de servidor con el mismo Control.ID valor de propiedad.(Heredado de Control).

System_CAPS_pubpropertyOnClientClick

Obtiene o establece el script de cliente que se ejecuta cuando un ImageButton del control Click provoca el evento.

System_CAPS_pubpropertyPage

Obtiene una referencia a la Page instancia que contiene el control de servidor.(Heredado de Control).

System_CAPS_pubpropertyParent

Obtiene una referencia al control principal del control de servidor en la jerarquía de controles de página.(Heredado de Control).

System_CAPS_pubpropertyPostBackUrl

Obtiene o establece la dirección URL de la página para registrar para la actual página cuando el ImageButton se hace clic en el control.

System_CAPS_pubpropertyRenderingCompatibility

Obtiene un valor que especifica será compatible con la versión de ASP.NET que se representa en HTML.(Heredado de Control).

System_CAPS_pubpropertySite

Obtiene información sobre el contenedor que hospeda el control actual cuando se representa en una superficie de diseño.(Heredado de Control).

System_CAPS_pubpropertySkinID

Obtiene o establece la máscara que se aplica al control.(Heredado de WebControl).

System_CAPS_pubpropertyStyle

Obtiene una colección de atributos de texto que se representan como un atributo de estilo en la etiqueta externa del control de servidor Web.(Heredado de WebControl).

System_CAPS_pubpropertySupportsDisabledAttribute

Obtiene un valor que indica si el control debe establecer en "disabled" el atributo disabled del elemento HTML representado cuando el valor de la propiedad IsEnabled del control es false.(Invalida Image.SupportsDisabledAttribute).

System_CAPS_pubpropertyTabIndex

Obtiene o establece el índice de tabulación del control de servidor Web.(Heredado de WebControl).

System_CAPS_protpropertyTagKey

Obtiene el HtmlTextWriterTag valor que corresponde a la ImageButton control.(Invalida WebControl.TagKey).

System_CAPS_protpropertyTagName

Obtiene el nombre de la etiqueta del control. Esta propiedad la usan principalmente los programadores de controles.(Heredado de WebControl).

System_CAPS_pubpropertyTemplateControl

Obtiene o establece una referencia a la plantilla que contiene este control.(Heredado de Control).

System_CAPS_pubpropertyTemplateSourceDirectory

Obtiene el directorio virtual de la Page o UserControl que contiene el control de servidor actual.(Heredado de Control).

System_CAPS_protpropertyText

Esta API admite la infraestructura producto y no está diseñada para usarse directamente desde el código. Obtiene o establece el valor de la ImageButton del control AlternateText propiedad.

System_CAPS_pubpropertyToolTip

Obtiene o establece el texto mostrado cuando el puntero del mouse se sitúa sobre el control de servidor Web.(Heredado de WebControl).

System_CAPS_pubpropertyUniqueID

Obtiene el identificador único calificado jerárquicamente para el control de servidor.(Heredado de Control).

System_CAPS_pubpropertyValidateRequestMode

Obtiene o establece un valor que indica si el control comprueba la entrada del cliente desde el Explorador de valores potencialmente peligrosos.(Heredado de Control).

System_CAPS_pubpropertyValidationGroup

Obtiene o establece el grupo de controles para los que el ImageButton control ejecuta la validación cuando realiza devoluciones al servidor.

System_CAPS_protpropertyViewState

Obtiene un diccionario de información de estado que permite guardar y restaurar el estado de vista de un control de servidor a través de varias solicitudes de la misma página.(Heredado de Control).

System_CAPS_protpropertyViewStateIgnoresCase

Obtiene un valor que indica si la StateBag objeto distingue mayúsculas de minúsculas.(Heredado de Control).

System_CAPS_pubpropertyViewStateMode

Obtiene o establece el modo de estado de vista de este control.(Heredado de Control).

System_CAPS_pubpropertyVisible

Obtiene o establece un valor que indica si un control de servidor se representa como interfaz de usuario en la página.(Heredado de Control).

System_CAPS_pubpropertyWidth

Obtiene o establece el ancho del control de servidor web.(Heredado de WebControl).

NombreDescripción
System_CAPS_protmethodAddAttributesToRender(HtmlTextWriter)

Agrega los atributos de un ImageButton al flujo de salida para representar en el cliente.(Invalida Image.AddAttributesToRender(HtmlTextWriter)).

System_CAPS_protmethodAddedControl(Control, Int32)

Se llama después de que se agrega un control secundario a la Controls colección de la Control objeto.(Heredado de Control).

System_CAPS_protmethodAddParsedSubObject(Object)

Notifica al control de servidor que se analizó un elemento, ya sea XML o HTML, y agrega el elemento al objeto ControlCollection del control del servidor.(Heredado de Control).

System_CAPS_pubmethodApplyStyle(Style)

Copia los elementos no vacíos del estilo especificado en el control Web, sobrescribiendo los elementos de estilo existentes del control. Este método se utiliza principalmente los programadores de controles.(Heredado de WebControl).

System_CAPS_pubmethodApplyStyleSheetSkin(Page)

Se aplica a las propiedades de estilo definidas en la hoja de estilo de página para el control.(Heredado de Control).

System_CAPS_protmethodBeginRenderTracing(TextWriter, Object)

Comienza el seguimiento de tiempo de diseño de datos de representación.(Heredado de Control).

System_CAPS_protmethodBuildProfileTree(String, Boolean)

Esta API admite la infraestructura producto y no está diseñada para usarse directamente desde el código. Recopila información sobre el control de servidor y la pasa a la Trace propiedad que se mostrará cuando el seguimiento está habilitado para la página.(Heredado de Control).

System_CAPS_protmethodClearCachedClientID()

Esta API admite la infraestructura producto y no está diseñada para usarse directamente desde el código. Establece la caché ClientID valor a null.(Heredado de Control).

System_CAPS_protmethodClearChildControlState()

Elimina la información de estado de control para los controles secundarios del control de servidor.(Heredado de Control).

System_CAPS_protmethodClearChildState()

Elimina la información de estado de vista y el estado de control para los controles secundarios todos del control de servidor.(Heredado de Control).

System_CAPS_protmethodClearChildViewState()

Elimina la información de estado de vista para todo el servidor controles secundarios del control.(Heredado de Control).

System_CAPS_protmethodClearEffectiveClientIDMode()

Esta API admite la infraestructura producto y no está diseñada para usarse directamente desde el código. Establece el ClientIDMode propiedad de la instancia actual del control y de todos los controles secundarios a Inherit.(Heredado de Control).

System_CAPS_pubmethodCopyBaseAttributes(WebControl)

Copia las propiedades que no están encapsuladas por la Style objeto desde el control de servidor Web especificado al control de servidor Web que se llama a este método. Este método se usa principalmente los programadores de controles.(Heredado de WebControl).

System_CAPS_protmethodCreateChildControls()

Lo llama el marco de páginas ASP.NET para indicar a los controles de servidor que usan la implementación basada en composición que creen los controles secundarios que contengan como forma de preparar la devolución o representación de los datos.(Heredado de Control).

System_CAPS_protmethodCreateControlCollection()

Crea un nuevo objeto ControlCollection que contendrá los controles secundarios (de literal y servidor) del control de servidor.(Heredado de Control).

System_CAPS_protmethodCreateControlStyle()

Crea el objeto de estilo que se usa internamente el WebControl propiedades relacionadas con la clase para implementar todos los estilos. Este método se usa principalmente los programadores de controles.(Heredado de WebControl).

System_CAPS_pubmethodDataBind()

Enlaza un origen de datos al control de servidor invocado y a todos sus controles secundarios.(Heredado de Control).

System_CAPS_protmethodDataBind(Boolean)

Enlaza un origen de datos para el control de servidor invocado y todos sus controles secundarios con una opción para generar el DataBinding eventos.(Heredado de Control).

System_CAPS_protmethodDataBindChildren()

Enlaza un origen de datos a los controles secundarios del control de servidor.(Heredado de Control).

System_CAPS_pubmethodDispose()

Habilita un control de servidor realizar la limpieza final antes de que se libere de la memoria.(Heredado de Control).

System_CAPS_protmethodEndRenderTracing(TextWriter, Object)

Finaliza el seguimiento de tiempo de diseño de datos de representación.(Heredado de Control).

System_CAPS_protmethodEnsureChildControls()

Determina si el control de servidor contiene controles secundarios. Si no es así, crea controles secundarios.(Heredado de Control).

System_CAPS_protmethodEnsureID()

Crea un identificador para los controles que no tienen un identificador asignado.(Heredado de Control).

System_CAPS_pubmethodEquals(Object)

Determina si el objeto especificado es igual al objeto actual.(Heredado de Object).

System_CAPS_protmethodFinalize()

Permite que un objeto intente liberar recursos y realizar otras operaciones de limpieza antes de ser reclamado por el recolector de basura. (Heredado de Object).

System_CAPS_pubmethodFindControl(String)

Busca el contenedor de nomenclatura actual para un control de servidor con el parámetro id parámetro.(Heredado de Control).

System_CAPS_protmethodFindControl(String, Int32)

Esta API admite la infraestructura producto y no está diseñada para usarse directamente desde el código. Busca el contenedor de nomenclatura actual para un control de servidor con el parámetro id y un entero especificado en el pathOffset parámetro, lo que ayuda en la búsqueda. No se debe reemplazar esta versión de la FindControl (método).(Heredado de Control).

System_CAPS_pubmethodFocus()

Establece el foco en un control de entrada.(Heredado de Control).

System_CAPS_protmethodGetDesignModeState()

Esta API admite la infraestructura producto y no está diseñada para usarse directamente desde el código. Obtiene los datos de tiempo de diseño para un control.(Heredado de Control).

System_CAPS_pubmethodGetHashCode()

Sirve como la función hash predeterminada.(Heredado de Object).

System_CAPS_protmethodGetPostBackOptions()

Crea un PostBackOptions objeto que representa la ImageButton comportamiento de postback del control.

System_CAPS_pubmethodGetRouteUrl(Object)

Obtiene la dirección URL que corresponde a un conjunto de parámetros de ruta.(Heredado de Control).

System_CAPS_pubmethodGetRouteUrl(RouteValueDictionary)

Obtiene la dirección URL que corresponde a un conjunto de parámetros de ruta.(Heredado de Control).

System_CAPS_pubmethodGetRouteUrl(String, Object)

Obtiene la dirección URL que corresponde a un conjunto de parámetros de ruta y un nombre de ruta.(Heredado de Control).

System_CAPS_pubmethodGetRouteUrl(String, RouteValueDictionary)

Obtiene la dirección URL que corresponde a un conjunto de parámetros de ruta y un nombre de ruta.(Heredado de Control).

System_CAPS_pubmethodGetType()

Obtiene el Type de la instancia actual.(Heredado de Object).

System_CAPS_pubmethodGetUniqueIDRelativeTo(Control)

Devuelve la parte fija de la UniqueID propiedad del control especificado.(Heredado de Control).

System_CAPS_pubmethodHasControls()

Determina si el control de servidor contiene todos los controles secundarios.(Heredado de Control).

System_CAPS_protmethodHasEvents()

Devuelve un valor que indica si se registran eventos para el control o los controles secundarios.(Heredado de Control).

System_CAPS_protmethodIsLiteralContent()

Esta API admite la infraestructura producto y no está diseñada para usarse directamente desde el código. Determina si el control de servidor alberga únicamente contenido literal.(Heredado de Control).

System_CAPS_protmethodLoadControlState(Object)

Restaura la información de estado de control de una solicitud de página anterior guardada por el SaveControlState (método).(Heredado de Control).

System_CAPS_protmethodLoadPostData(String, NameValueCollection)

Procesa los datos expuestos para el control ImageButton.

System_CAPS_protmethodLoadViewState(Object)

Restaura la información de estado de vista de una solicitud anterior guardada con el método SaveViewState.(Heredado de WebControl).

System_CAPS_protmethodMapPathSecure(String)

Recupera la ruta de acceso física que se asigna una ruta de acceso virtual absoluta o relativa, a.(Heredado de Control).

System_CAPS_protmethodMemberwiseClone()

Crea una copia superficial del Object actual.(Heredado de Object).

System_CAPS_pubmethodMergeStyle(Style)

Copia los elementos no vacíos del estilo especificado en el Web controlan pero no sobrescribirá ningún elemento de estilo existente del control. Este método se usa principalmente los programadores de controles.(Heredado de WebControl).

System_CAPS_protmethodOnBubbleEvent(Object, EventArgs)

Determina si el evento del control de servidor se pasa a la jerarquía de control de servidor de la interfaz de usuario (UI) de la página.(Heredado de Control).

System_CAPS_protmethodOnClick(ImageClickEventArgs)

Genera el Click eventos y permite controlar la Click directamente el evento.

System_CAPS_protmethodOnCommand(CommandEventArgs)

Genera el Command eventos y permite controlar la Command directamente el evento.

System_CAPS_protmethodOnDataBinding(EventArgs)

Genera el evento DataBinding.(Heredado de Control).

System_CAPS_protmethodOnInit(EventArgs)

Genera el evento Init.(Heredado de Control).

System_CAPS_protmethodOnLoad(EventArgs)

Genera el evento Load.(Heredado de Control).

System_CAPS_protmethodOnPreRender(EventArgs)

Determina si la imagen se ha hecho clic antes de representarlo en el cliente.(Invalida Control.OnPreRender(EventArgs)).

System_CAPS_protmethodOnUnload(EventArgs)

Genera el evento Unload.(Heredado de Control).

System_CAPS_protmethodOpenFile(String)

Obtiene un Stream utilizado para leer un archivo.(Heredado de Control).

System_CAPS_protmethodRaiseBubbleEvent(Object, EventArgs)

Asigna los orígenes del evento y su información al elemento primario del control.(Heredado de Control).

System_CAPS_protmethodRaisePostBackEvent(String)

Genera eventos para el control ImageButton cuando devuelve datos al servidor.

System_CAPS_protmethodRaisePostDataChangedEvent()

Notifica a la aplicación de ASP.NET que el estado del control ImageButton cambió.

System_CAPS_protmethodRemovedControl(Control)

Se llama después de que se quita un control secundario de la Controls colección de la Control objeto.(Heredado de Control).

System_CAPS_protmethodRender(HtmlTextWriter)

Representa el control en el sistema de escritura HTML especificado.(Heredado de WebControl).

System_CAPS_pubmethodRenderBeginTag(HtmlTextWriter)

Representa la etiqueta HTML de apertura del control en el escritor especificado. Este método se usa principalmente los programadores de controles.(Heredado de WebControl).

System_CAPS_protmethodRenderChildren(HtmlTextWriter)

Envía el contenido de los elementos secundarios de un control de servidor a un HtmlTextWriter objeto, que escribe el contenido que se va a representar en el cliente.(Heredado de Control).

System_CAPS_protmethodRenderContents(HtmlTextWriter)

Presenta la imagen del contenido del control en el escritor especificado.(Heredado de Image).

System_CAPS_pubmethodRenderControl(HtmlTextWriter)

Genera el contenido del control de servidor a un HtmlTextWriter de objeto y almacena información de seguimiento sobre el control si está habilitado el seguimiento.(Heredado de Control).

System_CAPS_protmethodRenderControl(HtmlTextWriter, ControlAdapter)

Genera el contenido del control de servidor a un HtmlTextWriter objeto usando una URL ControlAdapter objeto.(Heredado de Control).

System_CAPS_pubmethodRenderEndTag(HtmlTextWriter)

Representa la etiqueta HTML de cierre del control en el escritor especificado. Este método se usa principalmente los programadores de controles.(Heredado de WebControl).

System_CAPS_protmethodResolveAdapter()

Obtiene el adaptador de control responsable de representar el control especificado.(Heredado de Control).

System_CAPS_pubmethodResolveClientUrl(String)

Obtiene una dirección URL que se puede usar el explorador.(Heredado de Control).

System_CAPS_pubmethodResolveUrl(String)

Convierte una dirección URL en una que se puede usar en el cliente solicitante.(Heredado de Control).

System_CAPS_protmethodSaveControlState()

Guarda los cambios de estado del control de servidor que se produjeron desde la hora en que la página volvió a publicarse en el servidor.(Heredado de Control).

System_CAPS_protmethodSaveViewState()

Guarda cualquier estado que se modificó después que el TrackViewState se invocó el método.(Heredado de WebControl).

System_CAPS_protmethodSetDesignModeState(IDictionary)

Establece los datos en tiempo de diseño para un control.(Heredado de Control).

System_CAPS_pubmethodSetRenderMethodDelegate(RenderMethod)

Esta API admite la infraestructura producto y no está diseñada para usarse directamente desde el código. Asigna un delegado de controlador de eventos para representar el control de servidor y su contenido en el control principal.(Heredado de Control).

System_CAPS_pubmethodSetTraceData(Object, Object)

Conjuntos de datos de tiempo de diseño realiza un seguimiento de procesamiento de datos, utilizando la clave de datos de seguimiento y el valor de datos de seguimiento de seguimiento.(Heredado de Control).

System_CAPS_pubmethodSetTraceData(Object, Object, Object)

Conjuntos de datos de tiempo de diseño realiza un seguimiento de procesamiento de datos, utilizando el objeto de seguimiento, la clave de datos de seguimiento y el valor de datos de seguimiento de traza.(Heredado de Control).

System_CAPS_pubmethodToString()

Devuelve una cadena que representa al objeto actual. (Heredado de Object).

System_CAPS_protmethodTrackViewState()

Hace que el control realizar un seguimiento de los cambios en su estado de vista para que puedan almacenarse en el objeto ViewState propiedad.(Heredado de WebControl).

NombreDescripción
System_CAPS_pubeventClick

Se produce cuando se hace clic en ImageButton.

System_CAPS_pubeventCommand

Se produce cuando se hace clic en ImageButton.

System_CAPS_pubeventDataBinding

Se produce cuando el control de servidor se enlaza a un origen de datos.(Heredado de Control).

System_CAPS_pubeventDisposed

Se produce cuando un control de servidor se libera de la memoria, que es la última fase del ciclo de vida del control de servidor cuando se solicita una página ASP.NET.(Heredado de Control).

System_CAPS_pubeventInit

Se produce cuando se inicializa el control de servidor, que es el primer paso del ciclo de vida.(Heredado de Control).

System_CAPS_pubeventLoad

Se produce cuando el control de servidor se carga en el Page objeto.(Heredado de Control).

System_CAPS_pubeventPreRender

Se produce después de la Control es cargado pero antes de la representación.(Heredado de Control).

System_CAPS_pubeventUnload

Se produce cuando el control de servidor se descarga de la memoria.(Heredado de Control).

NombreDescripción
System_CAPS_pubinterfaceSystem_CAPS_priveventIButtonControl.Click

Esta API admite la infraestructura producto y no está diseñada para usarse directamente desde el código. Para obtener una descripción de este miembro, vea el IButtonControl.Click eventos.

System_CAPS_pubinterfaceSystem_CAPS_privmethodIAttributeAccessor.GetAttribute(String)

Esta API admite la infraestructura producto y no está diseñada para usarse directamente desde el código. Obtiene un atributo del control Web con el nombre especificado.(Heredado de WebControl).

System_CAPS_pubinterfaceSystem_CAPS_privmethodIAttributeAccessor.SetAttribute(String, String)

Establece un atributo del control Web en el nombre y valor especificados.(Heredado de WebControl).

System_CAPS_pubinterfaceSystem_CAPS_privmethodIControlDesignerAccessor.GetDesignModeState()

Para una descripción de este miembro, vea IControlDesignerAccessor.GetDesignModeState.(Heredado de Control).

System_CAPS_pubinterfaceSystem_CAPS_privmethodIControlDesignerAccessor.SetDesignModeState(IDictionary)

Para una descripción de este miembro, vea IControlDesignerAccessor.SetDesignModeState.(Heredado de Control).

System_CAPS_pubinterfaceSystem_CAPS_privmethodIControlDesignerAccessor.SetOwnerControl(Control)

Esta API admite la infraestructura producto y no está diseñada para usarse directamente desde el código. Para una descripción de este miembro, vea IControlDesignerAccessor.SetOwnerControl.(Heredado de Control).

System_CAPS_pubinterfaceSystem_CAPS_privmethodIParserAccessor.AddParsedSubObject(Object)

Para una descripción de este miembro, vea IParserAccessor.AddParsedSubObject.(Heredado de Control).

System_CAPS_pubinterfaceSystem_CAPS_privmethodIPostBackDataHandler.LoadPostData(String, NameValueCollection)

Esta API admite la infraestructura producto y no está diseñada para usarse directamente desde el código. Para una descripción de este miembro, vea IPostBackDataHandler.LoadPostData.

System_CAPS_pubinterfaceSystem_CAPS_privmethodIPostBackDataHandler.RaisePostDataChangedEvent()

Esta API admite la infraestructura producto y no está diseñada para usarse directamente desde el código. Para una descripción de este miembro, vea IPostBackDataHandler.RaisePostDataChangedEvent.

System_CAPS_pubinterfaceSystem_CAPS_privmethodIPostBackEventHandler.RaisePostBackEvent(String)

Esta API admite la infraestructura producto y no está diseñada para usarse directamente desde el código. Para una descripción de este miembro, vea IPostBackEventHandler.RaisePostBackEvent.

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIControlBuilderAccessor.ControlBuilder

Para una descripción de este miembro, vea IControlBuilderAccessor.ControlBuilder.(Heredado de Control).

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIControlDesignerAccessor.UserData

Para una descripción de este miembro, vea IControlDesignerAccessor.UserData.(Heredado de Control).

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIDataBindingsAccessor.DataBindings

Para una descripción de este miembro, vea IDataBindingsAccessor.DataBindings.(Heredado de Control).

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIDataBindingsAccessor.HasDataBindings

Para una descripción de este miembro, vea IDataBindingsAccessor.HasDataBindings.(Heredado de Control).

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIExpressionsAccessor.Expressions

Para una descripción de este miembro, vea IExpressionsAccessor.Expressions.(Heredado de Control).

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIExpressionsAccessor.HasExpressions

Para una descripción de este miembro, vea IExpressionsAccessor.HasExpressions.(Heredado de Control).

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIButtonControl.Text

Esta API admite la infraestructura producto y no está diseñada para usarse directamente desde el código. Para una descripción de este miembro, vea IButtonControl.Text.

NombreDescripción
System_CAPS_pubmethodFindDataSourceControl()

Devuelve el origen de datos que está asociado con el control de datos para el control especificado.(Definido por DynamicDataExtensions).

System_CAPS_pubmethodFindFieldTemplate(String)

Devuelve que el contenedor de nomenclatura de la plantilla de campo para la columna especificada en el control especificado.(Definido por DynamicDataExtensions).

System_CAPS_pubmethodFindMetaTable()

Devuelve el objeto de metatabla para el control de datos que contiene.(Definido por DynamicDataExtensions).

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

Tanto el Click y Command se generan eventos cuando el ImageButton se hace clic en el control.

Puede usar el OnCommand el controlador de eventos para realizar la ImageButton control se comporte como un botón de comando. Un nombre de comando se puede asociar con el control mediante la CommandName propiedad. Esto permite que varios ImageButton controles se ubican en la misma página Web. El valor de la CommandName propiedad, a continuación, se puede identificar mediante programación en el OnCommand el controlador de eventos para determinar la acción apropiada que debe realizarse cuando cada ImageButton se hace clic en el control. El CommandArgument propiedad también puede utilizarse para pasar información adicional sobre el comando, como especificar el orden ascendente.

Mediante el ImageButton control es similar a usar ASP.NET Button control. Para obtener más información, consulta Button Web Server Controls Content Map. y la información general para el Button control.

Mediante el uso de la OnClick el controlador de eventos, se pueden determinar mediante programación las coordenadas donde se hace clic en la imagen. A continuación, puede codificar una respuesta, según los valores de las coordenadas. Tenga en cuenta que el origen (0, 0) se encuentra en la esquina superior izquierda de la imagen.

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

Para obtener información acerca de cómo configurar este control para que genere un marcado que cumple los estándares de accesibilidad, consulte Accessibility in Visual Studio and ASP.NET y ASP.NET Controls and Accessibility.

<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"
/>

Un proyecto de sitio Web de Visual Studio con código fuente está disponible para este tema: Download.

En el ejemplo de código siguiente se muestra cómo crear un ImageButton control que muestra las coordenadas en el que se hace clic en una imagen.

System_CAPS_noteNota

El siguiente ejemplo de código utiliza el modelo de código de un solo archivo y puede no funcionar correctamente si se copia directamente en un archivo de código subyacente. Este ejemplo de código debe copiarse 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 formularios Web Forms, vea ASP.NET Web Forms Page Code Model.

<%@ 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 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>

.NET Framework
Disponible desde 1.1

Cualquier miembro ( Compartido en Visual Basic) estático público de este tipo es seguro para subprocesos. No se garantiza que los miembros de instancia sean seguros para subprocesos.

Volver al principio
Mostrar: