Esta documentación está archivada y no tiene mantenimiento.

Image (Clase)

Actualización: noviembre 2007

Muestra una imagen en una página Web móvil.

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

[AspNetHostingPermissionAttribute(SecurityAction.InheritanceDemand, Level = AspNetHostingPermissionLevel.Minimal)]
[AspNetHostingPermissionAttribute(SecurityAction.LinkDemand, Level = AspNetHostingPermissionLevel.Minimal)]
public class Image : MobileControl, IPostBackEventHandler
/** @attribute AspNetHostingPermissionAttribute(SecurityAction.InheritanceDemand, Level = AspNetHostingPermissionLevel.Minimal) */
/** @attribute AspNetHostingPermissionAttribute(SecurityAction.LinkDemand, Level = AspNetHostingPermissionLevel.Minimal) */
public class Image extends MobileControl implements IPostBackEventHandler
public class Image extends MobileControl implements IPostBackEventHandler
<mobile:Image />

La clase Image proporciona una manera de elegir un archivo de imagen según las características del dispositivo. Para ciertos dispositivos, se pueden especificar imágenes integradas utilizando un prefijo symbol: como parte de la dirección URL de la propiedad ImageUrl. Para obtener más información, vea la sección específica del dispositivo del control Image.

k8625few.alert_note(es-es,VS.90).gifNota:

Si la aplicación se basa en sesiones sin cookies, o puede recibir solicitudes de exploradores que requieren sesiones sin cookies, el uso de una tilde ("~") en una ruta de acceso puede dar lugar a la creación inadvertida de una nueva sesión y a la pérdida potencial de los datos de la sesión. Para establecer una propiedad con una ruta de acceso como ("~/ruta de acceso"), resuelva la ruta de acceso utilizando ResolveUrl("~/ruta de acceso") antes de su asignación a la propiedad.

En el ejemplo de código siguiente se muestra cómo usar un control < DeviceSpecific > dentro de un control Image para especificar imágenes diferentes para dispositivos diferentes. Si dispone de un archivo denominado Sunshine.gif, aparecerá en Internet Explorer. Si ve la página en un dispositivo WML, por ejemplo, un teléfono OpenWave o un dispositivo CHTML, se mostrará como un icono de sol. La página también muestra el nombre del explorador y el nombre resuelto de la imagen.

k8625few.alert_note(es-es,VS.90).gifNota:

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, vea Modelo de código de las páginas web ASP.NET.

<%@ Page Language="C#" 
    Inherits="System.Web.UI.MobileControls.MobilePage" %>
<%@ Register TagPrefix="mobile" 
    Namespace="System.Web.UI.MobileControls" 
    Assembly="System.Web.Mobile" %>

<script runat="server">
    protected void Page_Load(object sender, EventArgs e)
    {
        string spec1 = "Device: {0}";
        string spec2 = "Image source: {0}";

        if (!IsPostBack)
        {
            Label1.Text = String.Format(spec1,  Device.Browser);
            Label2.Text = string.Format(spec2, Image1.ImageUrl);
        }
    }
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<body>
    <mobile:form id="form1" runat="server">
        <mobile:Image ID="Image1" Runat="server" 
            AlternateText="Sunshine">

            <DeviceSpecific ID="imgDevSec" Runat="server">
                <Choice Filter="isWML11" 
                        ImageUrl="symbol:44" />
                <Choice Filter="isCHTML10" 
                        ImageUrl="symbol:63726" />
                <Choice ImageUrl="sunshine.gif" />
            </DeviceSpecific>

        </mobile:Image>
        <mobile:Label ID="Label1" Runat="server" />
        <mobile:Label ID="Label2" Runat="server" />
    </mobile:form>
</body>
</html>


Lo siguiente es la sección <deviceFilters> del archivo Web.config.

<deviceFilters>
  <filter name="isWML11" compare="PreferredRenderingType" argument="wml11" />
  <filter name="isCHTML10" compare="PreferredRenderingType" argument="chtml10" />
</deviceFilters>


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.

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.

.NET Framework

Compatible con: 3.5, 3.0, 2.0, 1.1
Mostrar: