ImageButton (Clase) (System.Web.UI.WebControls)

Contraer todo

Filtro de lenguage

Esta página es específica de

Microsoft Visual Studio 2008/.NET Framework 3.5

Hay además otras versiones disponibles para:

Biblioteca de clases de .NET Framework

ImageButton (Clase)

Actualización: noviembre 2007

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)

Sintaxis

Visual Basic (Declaración)

<AspNetHostingPermissionAttribute(SecurityAction.LinkDemand, Level := AspNetHostingPermissionLevel.Minimal)> _
<AspNetHostingPermissionAttribute(SecurityAction.InheritanceDemand, Level := AspNetHostingPermissionLevel.Minimal)> _
Public Class ImageButton _
    Inherits Image _
    Implements IPostBackDataHandler, IPostBackEventHandler, IButtonControl

Visual Basic (Uso)

Dim instance As ImageButton

[AspNetHostingPermissionAttribute(SecurityAction.LinkDemand, Level = AspNetHostingPermissionLevel.Minimal)]
[AspNetHostingPermissionAttribute(SecurityAction.InheritanceDemand, Level = AspNetHostingPermissionLevel.Minimal)]
public class ImageButton : Image, 
    IPostBackDataHandler, IPostBackEventHandler, IButtonControl

Visual C++

[AspNetHostingPermissionAttribute(SecurityAction::LinkDemand, Level = AspNetHostingPermissionLevel::Minimal)]
[AspNetHostingPermissionAttribute(SecurityAction::InheritanceDemand, Level = AspNetHostingPermissionLevel::Minimal)]
public ref class ImageButton : public Image, 
    IPostBackDataHandler, IPostBackEventHandler, IButtonControl

/** @attribute AspNetHostingPermissionAttribute(SecurityAction.LinkDemand, Level = AspNetHostingPermissionLevel.Minimal) */
/** @attribute AspNetHostingPermissionAttribute(SecurityAction.InheritanceDemand, Level = AspNetHostingPermissionLevel.Minimal) */
public class ImageButton extends Image implements IPostBackDataHandler, 
    IPostBackEventHandler, IButtonControl

JScript

public class ImageButton extends Image implements IPostBackDataHandler, IPostBackEventHandler, IButtonControl

ASP.NET

<asp:ImageButton />

Comentarios

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.

Utilizando el 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.

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, el valor de la propiedad CommandName 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.

De manera predeterminada, la validación de la página se realiza al hacer 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

Es posible que el marcado que se representa de manera predeterminada para este control no respete los estándares de accesibilidad enunciados en las directrices prioritarias de WCAG (Instrucciones de accesibilidad a contenido Web 1.0). Para obtener detalles sobre accesibilidad compatible con este control, vea Controles y accesibilidad en ASP.NET.

Topic	Location
Cómo: Agregar controles Button de servidor Web a una página de formularios Web Forms	Generar 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 Forms	Generar 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.NET	Generar aplicaciones Web ASP .NET
Cómo: Agregar un botón de inicio de sesión a una página Web ASP.NET	Generar aplicaciones Web ASP .NET en Visual Studio
Cómo: Determinar las coordenadas de un control ImageButton de servidor Web	Generar aplicaciones Web ASP .NET
Cómo: Determinar las coordenadas de un control ImageButton de servidor Web	Generar aplicaciones Web ASP .NET en Visual Studio
Cómo: Establecer el foco en los controles de servidor Web ASP.NET	Generar aplicaciones Web ASP .NET
Cómo: Establecer el foco en los controles de servidor Web ASP.NET	Generar aplicaciones Web ASP .NET en Visual Studio
Cómo: Responder a eventos Button en controles enlazados a datos	Generar aplicaciones Web ASP .NET
Cómo: Responder a eventos Button en controles enlazados a datos	Generar aplicaciones Web ASP .NET en Visual Studio
Cómo: Responder a los eventos de botón en elementos DataList o Repeater	Generar aplicaciones Web ASP .NET en Visual Studio
Cómo: Responder a los eventos de botón en elementos DataList, Repeater o GridView	Generar aplicaciones Web ASP .NET
Cómo: Responder a los eventos de un control Button de servidor Web	Generar aplicaciones Web ASP .NET
Cómo: Responder a los eventos de un control Button de servidor Web	Generar 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 cliente	Generar aplicaciones Web ASP .NET
Cómo: Responder a los eventos de un control Button de servidor Web en una secuencia de comandos del cliente	Generar aplicaciones Web ASP .NET en Visual Studio
Tutorial: Crear y usar páginas principales ASP.NET en Visual Web Developer	Generar aplicaciones Web ASP .NET en Visual Studio
Tutorial: Crear y usar páginas principales ASP.NET en Visual Web Developer	Generar aplicaciones con Visual Web Developer
Tutorial: Enlace de datos a un objeto comercial personalizado	Generar aplicaciones Web ASP .NET en Visual Studio
Tutorial: Enlace de datos a un objeto comercial personalizado	Generar aplicaciones Web ASP .NET en Visual Studio

Ejemplos

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.

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.

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.

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>

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

JScript

<%@ Page Language="JScript" 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="JSCRIPT" runat="server">

      function ImageButton_Click(sender : Object, e : ImageClickEventArgs) {
         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>

Permisos

AspNetHostingPermission
para trabajar en un entorno hospedado. Valor de la petición: LinkDemand. Valor del permiso: Minimal.
AspNetHostingPermission
para trabajar en un entorno hospedado. Valor de la petición: InheritanceDemand. Valor del permiso: Minimal.

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

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.

Plataformas

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

.NET Framework y .NET Compact Framework no admiten todas las versiones de cada plataforma. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.

Información de versión