MenuItem.Target Propriedade

Definição

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

Obtém ou define a janela ou frame-alvo onde mostrar o conteúdo da página Web associado a um item do menu.

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 seguinte demonstra como usar a Target propriedade para especificar uma janela ou frame onde o conteúdo Web está ligado a um item do menu quando esse item é clicado.


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

Observações

Use a Target propriedade para especificar a janela ou moldura onde deve ser exibido o conteúdo Web ligado a um item do menu quando esse item for clicado. Os valores devem começar com uma letra no intervalo de A a Z (indistinto a maiúsculas e maiúsculas), exceto certos valores especiais que começam com sublinhado, como mostrado na tabela seguinte. Note que definir esta propriedade sobrepõe a Target propriedade do Menu controlo para este item do menu.

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 é representada como um target atributo. O target atributo nos elementos âncora não é permitido na definição estrita de tipo de documento XHTML 1.1. Não defina a Target propriedade se a saída HyperLink renderizada for compatível com XHTML 1.1. Para mais informações, consulte XHTML Standards in 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 Acessibilidade em Visual Studio e ASP.NET.

Aplica-se a

Ver também