MenuItem.Target MenuItem.Target MenuItem.Target MenuItem.Target Property

Definición

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ú.Gets or sets the target window or frame in which to display the Web page content associated with a menu item.

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

Ventana o marco de destino en que se debe mostrar el contenido de página web vinculado.The target window or frame in which to display the linked Web page content. El valor predeterminado es una cadena vacía ("") que actualiza la ventana o el marco con el foco.The default value is an empty string (""), which refreshes the window or frame with focus.

Ejemplos

En el ejemplo siguiente se muestra cómo usar el Target propiedad para especificar una 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ú.The following example demonstrates how to use the Target property to specify a window or frame in which to display the Web content linked to a menu item when that menu item is clicked.


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

Use el 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ú.Use the Target property to specify the window or frame in which to display the Web content linked to a menu item when that menu item is clicked. 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.Values must begin with a letter in the range of A through Z (case-insensitive), except for certain special values that begin with an underscore, as shown in the following table. Tenga en cuenta que al establecer esta propiedad invalida la Target propiedad de la Menu control para este elemento de menú.Note that setting this property overrides the Target property of the Menu control for this menu item.

Valor del objetivoTarget value DescripciónDescription
_blank Representa el contenido en una nueva ventana sin marcos.Renders the content in a new window without frames.
_parent Representa el contenido en el conjunto de marcos principal inmediato.Renders the content in the immediate frameset parent.
_search Representa el contenido en el panel de búsqueda.Renders the content in the search pane.
_self Representa el contenido en el marco con foco.Renders the content in the frame with focus.
_top Representa el contenido en una ventana completa sin marcos.Renders the content in the full window without frames.

Nota

Consulte la documentación del explorador para determinar si admite el valor _search.Check your browser documentation to determine if the _search value is supported. Por ejemplo, Microsoft Internet Explorer 5.0 y versiones posteriores admiten el valor de destino _search.For example, Microsoft Internet Explorer 5.0 and later support the _search target value.

Nota

El Target propiedad se representa como un target atributo.The Target property is rendered as a target attribute. El target no se permite el atributo en los elementos de anclaje en la definición de tipo de documento strict de XHTML 1.1.The target attribute on anchor elements is not allowed in the XHTML 1.1 strict document type definition. No establezca la Target propiedad si el resultado representado para el HyperLink debe ser XHTML 1.1 compatible.Do not set the Target property if the rendered output for the HyperLink must be XHTML 1.1-compliant. Para obtener más información, consulte estándares de XHTML en Visual Studio y ASP.NET.For more information, see XHTML Standards in Visual Studio and ASP.NET.

Al crear páginas Web accesibles, se recomienda encarecidamente que evite usar el Target propiedad en otra ventana de destino.When creating accessible Web pages, it is strongly recommended you avoid using the Target property to target another window. Para obtener más información, consulte accesibilidad en Visual Studio y ASP.NET.For more information, see Accessibility in Visual Studio and ASP.NET.

Se aplica a

Consulte también: