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 utilizar Target la propiedad para especificar una ventana o un 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

Utilice la Target propiedad para especificar la ventana o el marco en el que se va a mostrar el contenido web vinculado a un elemento de menú cuando se haga 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 se Target invalida la propiedad Menu del 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

La Target propiedad se representa como un target atributo.The Target property is rendered as a target attribute. El target atributo de los elementos de delimitador no se permite en la definición de tipo de documento de XHTML 1,1 STRICT.The target attribute on anchor elements is not allowed in the XHTML 1.1 strict document type definition. No establezca la Target propiedad si la salida representada HyperLink para debe ser compatible con XHTML 1,1.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, vea 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 evitar el uso de Target la propiedad para destinarla a otra ventana.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 Accessibility in Visual Studio and ASP.NET (Accesibilidad en Visual Studio y ASP.NET).For more information, see Accessibility in Visual Studio and ASP.NET.

Se aplica a

Consulte también: