MenuItem.Target Propiedad

Referencia

Definición

Espacio de nombres:: System.Web.UI.WebControls

Ensamblado:: System.Web.dll

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

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ú.

public:
 property System::String ^ Target { System::String ^ get(); void set(System::String ^ value); };

public string Target { get; set; }

member this.Target : string with get, set

Public Property Target As String

Valor de propiedad

String

Ventana o marco de destino en que se debe mostrar el contenido de página web vinculado. El valor predeterminado es una cadena vacía ("") que actualiza la ventana o el marco con el foco.

Ejemplos

En el ejemplo siguiente se muestra cómo usar la Target propiedad para especificar una ventana o marco en el que mostrar el contenido web vinculado a un elemento de menú cuando se hace clic en 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>MenuItem Target Example</title>
</head>
<body>
    <form id="form1" runat="server">
    
      <h3>MenuItem Target Example</h3>
    
      <asp:menu id="NavigationMenu"
        staticdisplaylevels="1"
        staticsubmenuindent="10" 
        orientation="Vertical" 
        target="_blank"  
        runat="server">

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

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


<%@ Page Language="VB" %>

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

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

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

Comentarios

Utilice la Target propiedad para especificar la ventana o marco en el que se va a 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. Tenga en cuenta que al establecer esta propiedad se invalida la Target propiedad del Menu control para este elemento de menú.

Valor del objetivo	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.

Nota

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

Nota

La Target propiedad se representa como un target atributo . No target se permite el atributo en los elementos delimitadores en la definición de tipo de documento estricto XHTML 1.1. No establezca la Target propiedad si la salida representada para HyperLink debe ser compatible con XHTML 1.1. Para obtener más información, vea Estándares XHTML en Visual Studio y ASP.NET.

Al crear páginas web accesibles, se recomienda encarecidamente evitar el uso de la Target propiedad para tener como destino otra ventana. Para obtener más información, consulte Accessibility in Visual Studio and ASP.NET (Accesibilidad en Visual Studio y ASP.NET).

Se aplica a

Compartir a través de