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

Menu.Target (Propiedad)

Obtiene o establece la ventana o el marco de destino donde se mostrará el contenido de una página Web asociada a un elemento de menú.

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

public string Target { get; set; }
/** @property */
public String get_Target ()

/** @property */
public void set_Target (String value)

public function get Target () : String

public function set Target (value : String)

No aplicable.

Valor de propiedad

Ventana o marco de destino en que se va a mostrar el contenido de la página Web vinculada. El valor predeterminado es una cadena vacía (""), lo cual hace que se actualice la ventana o el marco que posee el foco.

Utilice la propiedad Target para especificar la ventana o el marco donde mostrar el contenido Web vinculado a un elemento de menú cuando se hace clic en ese elemento de menú. Los valores deben empezar por una letra entre la A y la Z (sin distinción entre mayúsculas y minúsculas), salvo ciertos valores especiales que empiezan por un carácter de subrayado, como se muestra en la tabla siguiente.

Valor del destino

Descripción

_blank

Representa el contenido en una nueva ventana sin marcos.

_parent

Representa el contenido en el conjunto de marcos principal inmediato.

_search

Representa el contenido en el panel de búsqueda.

_self

Representa el contenido en el marco con foco.

_top

Representa el contenido en una ventana completa sin marcos.

NotaNota:

Consulte la documentación del explorador para determinar si admite el valor _search. Por ejemplo, Internet Explorer 5.0 y las versiones posteriores admiten _search como valor de destino.

Esta propiedad se aplica a todos los elementos de menú de un control Menu. Puede reemplazar esta propiedad selectivamente estableciendo la propiedad Target de cada objeto MenuItem directamente.

NotaNota:

La propiedad Target se representa como un atributo target. En la definición estricta de tipos de documentos XHTML 1.1 no se admite el atributo target en la sintaxis de los elementos que definen vínculos de hipertexto. No establezca la propiedad Target si la representación del control HyperLink debe ser compatible con XHTML 1.1. Para obtener más información, consulte el tema ASP.NET y XHTML.

Durante la creación de páginas Web accesibles, se recomienda encarecidamente evitar el uso de la propiedad Target para seleccionar otra ventana como destino. Para obtener más información, vea Accesibilidad en ASP.NET.

El ejemplo de código siguiente muestra cómo utilizar la propiedad Target para especificar que el contenido vinculado a cada elemento de menú se debería mostrar en una nueva ventana cuando los usuarios hacen clic sobre ese elemento de menú.


<%@ Page Language="C#" %>

<!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 runat="server">
    <title>Menu Target Example</title>
</head>
<body>
    <form id="form1" runat="server">
    
      <h3>Menu Target Example</h3>
    
      <asp:menu id="NavigationMenu"
        staticdisplaylevels="2"
        staticsubmenuindent="10" 
        orientation="Vertical"
        target="_blank"  
        runat="server">

        <items>
          <asp:menuitem navigateurl="Home.aspx" 
            text="Home"
            tooltip="Home">
            <asp:menuitem navigateurl="Music.aspx"
              text="Music"
              tooltip="Music">
              <asp:menuitem navigateurl="Classical.aspx" 
                text="Classical"
                tooltip="Classical"/>
              <asp:menuitem navigateurl="Rock.aspx"
                text="Rock"
                tooltip="Rock"/>
              <asp:menuitem navigateurl="Jazz.aspx"
                text="Jazz"
                tooltip="Jazz"/>
            </asp:menuitem>
            <asp:menuitem navigateurl="Movies.aspx"
              text="Movies"
              tooltip="Movies">
              <asp:menuitem navigateurl="Action.aspx"
                text="Action"
                tooltip="Action"/>
              <asp:menuitem navigateurl="Drama.aspx"
                text="Drama"
                tooltip="Drama"/>
              <asp:menuitem navigateurl="Musical.aspx"
                text="Musical"
                tooltip="Musical"/>
            </asp:menuitem>
          </asp:menuitem>
        </items>
      
      </asp:menu>

    </form>
  </body>
</html>


Windows 98, Windows 2000 Service Pack 4, Windows CE, Windows Millennium, Windows Mobile para Pocket PC, Windows Mobile para Smartphone, Windows Server 2003, Windows XP Media Center, Windows XP Professional x64, Windows XP SP2, Windows XP Starter

Microsoft .NET Framework 3.0 es compatible con Windows Vista, Microsoft Windows XP SP2 y Windows Server 2003 SP1.

.NET Framework

Compatible con: 3.0, 2.0
Mostrar: