MenuItemBinding.Target Propriedade

Definição

Espaço de Nomes:: System.Web.UI.WebControls

Assemblagem:: System.Web.dll

Importante

Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.

Obtém ou define a janela ou frame-alvo onde exibir o conteúdo da página Web associado a um item de menu ao qual o MenuItemBinding objeto é aplicado.

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 Propriedade

String

A janela ou frame alvo onde é exibido o conteúdo da página Web ligada. O valor padrão é uma cadeia vazia (""), que atualiza a janela ou frame com o foco.

Exemplos

O exemplo de código seguinte demonstra como usar a Target propriedade para especificar a janela em que mostrar o conteúdo Web associado a um item do menu, quando esse item do menu é clicado. Para que este exemplo funcione corretamente, deve copiar os dados XML de exemplo abaixo para um ficheiro chamado 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>

O código seguinte é um exemplo de dados de mapa de sítios para o exemplo 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>

Observações

Quando o controlo Menu está ligado a uma fonte de dados, use a Target propriedade para especificar a janela ou frame em que o conteúdo Web está ligado a um item do menu quando esse item for clicado.

Note

Definir esta propriedade sobrepõe-se à Menu.Target propriedade do Menu controlo para os itens do menu aos quais o MenuItemBinding objeto é aplicado. Pode substituir seletivamente esta propriedade definindo diretamente a MenuItem.Target propriedade de cada item do menu.

Os valores-alvo devem começar com uma letra no intervalo de A a Z (indistinto a maiúsculas), exceto certos valores especiais que começam com sublinhado, como mostrado na tabela seguinte.

Valor alvo	Descrição
`_blank`	Renderiza o conteúdo numa nova janela sem frames.
`_parent`	Renderiza o conteúdo no frameset pai imediato.
`_search`	Renderiza o conteúdo no painel de pesquisa.
`_self`	Renderiza o conteúdo no enquadramento com foco.
`_top`	Renderiza o conteúdo na janela completa sem frames.

Note

Verifique a documentação do seu navegador para ver se o _search valor é suportado. Por exemplo, Microsoft Internet Explorer 5.0 e posteriores suportam o valor-alvo _search.

Note

A Target propriedade é renderizada como um target atributo. O target atributo sobre anchor elementos não é permitido na definição de tipo de documento XHTML 1.1. Não defina a Target propriedade se a saída renderizada do MenuItemBinding objeto tiver de ser compatível com XHTML 1.1. Para mais informações, consulte o tópico XHTML em Visual Studio e ASP.NET.

Ao criar páginas Web acessíveis, recomenda-se vivamente que evite usar a Target propriedade para direcionar outra janela. Para mais informações, consulte ASP.NET Acessibilidade.

Aplica-se a

Ver também

Comentários

Esta página foi útil?