MenuItemBinding.Target Propiedad

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 marco de destino en el que se va a mostrar el contenido de la página web asociado a un elemento de menú al que se aplica el MenuItemBinding objeto.

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 el que se va a mostrar el contenido de la página web vinculada. El valor predeterminado es una cadena vacía (""), que actualiza la ventana o marco con el foco.

Ejemplos

En el ejemplo de código siguiente se muestra cómo usar la Target propiedad para especificar la ventana en la que mostrar el contenido web asociado a un elemento de menú, cuando se hace clic en ese elemento de menú. Para que este ejemplo funcione correctamente, debe copiar los datos XML de ejemplo siguientes en un archivo denominado Menu.xml.


<%@ 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>MenuItemBinding Example</title>
</head>
<body>
    <form id="form1" runat="server">

      <h3>MenuItemBinding Example</h3>

      <asp:menu id="NavigationMenu"
        datasourceid="MenuSource"
        runat="server">
        
        <DataBindings>
        
          <asp:menuitembinding datamember="MapHomeNode"
            formatstring="({0})" 
            textfield="Title"
            valuefield="Description"
            imageurlfield="ImageUrl"
            tooltipfield="ToolTip"
            target="_self" />
          <asp:menuitembinding datamember="MapNode" 
            depth="1"
            formatstring="[{0}]" 
            textfield="Title"
            valuefield="Description"
            imageurlfield="ImageUrl"
            tooltipfield="ToolTip"
            target="_blank"/>
          <asp:menuitembinding datamember="MapNode" 
            depth="2"
            formatstring="<{0}>" 
            textfield="Title"
            valuefield="Description"
            imageurlfield="ImageUrl"
            tooltipfield="ToolTip"
            target="_blank"/>
          
        </DataBindings>
        
      </asp:menu>

      <asp:xmldatasource id="MenuSource"
        datafile="Menu.xml"
        runat="server"/> 

    </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>MenuItemBinding Example</title>
</head>
<body>
    <form id="form1" runat="server">

      <h3>MenuItemBinding Example</h3>

      <asp:menu id="NavigationMenu"
        datasourceid="MenuSource"
        runat="server">
        
        <DataBindings>
        
          <asp:menuitembinding datamember="MapHomeNode"
            formatstring="({0})" 
            textfield="Title"
            valuefield="Description"
            imageurlfield="ImageUrl"
            tooltipfield="ToolTip"
            target="_self" />
          <asp:menuitembinding datamember="MapNode" 
            depth="1"
            formatstring="[{0}]" 
            textfield="Title"
            valuefield="Description"
            imageurlfield="ImageUrl"
            tooltipfield="ToolTip"
            target="_blank"/>
          <asp:menuitembinding datamember="MapNode" 
            depth="2"
            formatstring="<{0}>" 
            textfield="Title"
            valuefield="Description"
            imageurlfield="ImageUrl"
            tooltipfield="ToolTip"
            target="_blank"/>
          
        </DataBindings>
        
      </asp:menu>

      <asp:xmldatasource id="MenuSource"
        datafile="Menu.xml"
        runat="server"/> 

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

El código siguiente es datos de mapa de sitio de ejemplo para el ejemplo anterior.

<MapHomeNode ImageUrl="~\Images\Home.gif"

Title="Home"

Description="Root Page"

ToolTip="Home Page">

<MapNode ImageUrl="~\Images\Music.gif"

Title="Music"

Description="Music Category"

ToolTip="Music Page">

<MapNode ImageUrl="~\Images\Classical.gif"

Title="Classical"

Description="Classical Section"

ToolTip="Classical Page"/>

<MapNode ImageUrl="~\Images\Rock.gif"

Title="Rock"

Description="Rock Section"

ToolTip="Rock Page"/>

<MapNode ImageUrl="~\Images\Jazz.gif"

Title="Jazz"

Description="Jazz Section"

ToolTip="Jazz Page"/>

</MapNode>

<MapNode ImageUrl="~\Images\Movies.gif"

Title="Movies"

Description="Movies Category"

ToolTip="Movies Page">

<MapNode ImageUrl="~\Images\Action.gif"

Title="Action"

Description="Action Section"

ToolTip="Action Page"/>

<MapNode ImageUrl="~\Images\Drama.gif"

Title="Drama"

Description="Drama Section"

ToolTip="Drama Page"/>

<MapNode ImageUrl="~\Images\Musical.gif"

Title="Musical"

Description="Musical Section"

ToolTip="Musical Page"/>

</MapNode>

</MapHomeNode>

Comentarios

Cuando el Menu control está enlazado a un origen de datos, 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ú.

Nota:

Establecer esta propiedad invalida la Menu.Target propiedad del control para los elementos de Menu menú a los que se aplica el MenuItemBinding objeto. Puede invalidar esta propiedad de forma selectiva estableciendo directamente la MenuItem.Target propiedad de cada elemento de menú.

Los valores de destino deben comenzar con una letra en el intervalo de A a Z (sin distinción entre mayúsculas y minúsculas), excepto para determinados valores especiales que comienzan con un carácter de subrayado, como se muestra en la tabla siguiente.

Valor objetivo	Descripción
`_blank`	Representa el contenido en una nueva ventana sin marcos.
`_parent`	Representa el contenido en el elemento primario del conjunto de marcos inmediato.
`_search`	Representa el contenido en el panel de búsqueda.
`_self`	Representa el contenido en el marco con el foco.
`_top`	Representa el contenido en la ventana completa sin marcos.

Nota:

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

Nota:

La Target propiedad se representa como un target atributo. No se permite el target atributo en anchor los elementos en la definición de tipo de documento XHTML 1.1. No establezca la Target propiedad si la salida representada para el MenuItemBinding objeto debe ser compatible con XHTML 1.1. Para obtener más información, consulte el tema 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 dirigirse a otra ventana. Para obtener más información, consulte ASP.NET Accesibilidad.

Se aplica a

Consulte también

Comentarios

¿Le resultó útil esta página?

Compartir vía

MenuItemBinding.Target Propiedad

Definición

Valor de propiedad

Ejemplos

Comentarios

Se aplica a

Consulte también

Comentarios