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

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 de código siguiente se muestra cómo usar la Target propiedad para especificar la ventana en la que se va a 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 un ejemplo de datos de mapa del sitio 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 propiedad para especificar la Target 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

Al establecer esta propiedad, se 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 por un carácter de subrayado, como se muestra en la tabla siguiente.

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 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 tener como destino otra ventana. Para obtener más información, consulte accesibilidad ASP.NET.

Se aplica a

MenuItemBinding.Target Propiedad

Definición

Valor de propiedad

Ejemplos

Comentarios

Se aplica a

Consulte también

Recursos adicionales