Share via

Menu.Target Propriedade

  • Referência

Definição

Namespace:
System.Web.UI.WebControls
Assembly:
System.Web.dll

Obtém ou define a janela ou o quadro de destino no qual deverá ser exibido o conteúdo da página da Web associado a um item de 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 da propriedade

String

A janela de destino ou quadro no qual exibir o conteúdo da página da Web vinculada. O valor padrão é uma cadeia de caracteres vazia (""), que atualiza a janela ou quadro com o foco.

Exemplos

O exemplo de código a seguir demonstra como usar a Target propriedade para especificar que o conteúdo vinculado a cada item de menu deve ser exibido em uma nova janela quando o usuário clica nesse item de menu.


<%@ 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>Menu Target Example</title>
</head>
<body>
    <form id="form1" runat="server">
    
      <h3>Menu Target Example</h3>
    
      <asp:menu id="NavigationMenu"
        staticdisplaylevels="2"
        staticsubmenuindent="10" 
        orientation="Vertical"
        target="_blank"  
        runat="server">

        <items>
          <asp:menuitem navigateurl="Home.aspx" 
            text="Home"
            tooltip="Home">
            <asp:menuitem navigateurl="Music.aspx"
              text="Music"
              tooltip="Music">
              <asp:menuitem navigateurl="Classical.aspx" 
                text="Classical"
                tooltip="Classical"/>
              <asp:menuitem navigateurl="Rock.aspx"
                text="Rock"
                tooltip="Rock"/>
              <asp:menuitem navigateurl="Jazz.aspx"
                text="Jazz"
                tooltip="Jazz"/>
            </asp:menuitem>
            <asp:menuitem navigateurl="Movies.aspx"
              text="Movies"
              tooltip="Movies">
              <asp:menuitem navigateurl="Action.aspx"
                text="Action"
                tooltip="Action"/>
              <asp:menuitem navigateurl="Drama.aspx"
                text="Drama"
                tooltip="Drama"/>
              <asp:menuitem navigateurl="Musical.aspx"
                text="Musical"
                tooltip="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>Menu Target Example</title>
</head>
<body>
    <form id="form1" runat="server">
    
      <h3>Menu Target Example</h3>
    
      <asp:menu id="NavigationMenu"
        staticdisplaylevels="2"
        staticsubmenuindent="10" 
        orientation="Vertical"
        target="_blank"  
        runat="server">

        <items>
          <asp:menuitem navigateurl="Home.aspx" 
            text="Home"
            tooltip="Home">
            <asp:menuitem navigateurl="Music.aspx"
              text="Music"
              tooltip="Music">
              <asp:menuitem navigateurl="Classical.aspx" 
                text="Classical"
                tooltip="Classical"/>
              <asp:menuitem navigateurl="Rock.aspx"
                text="Rock"
                tooltip="Rock"/>
              <asp:menuitem navigateurl="Jazz.aspx"
                text="Jazz"
                tooltip="Jazz"/>
            </asp:menuitem>
            <asp:menuitem navigateurl="Movies.aspx"
              text="Movies"
              tooltip="Movies">
              <asp:menuitem navigateurl="Action.aspx"
                text="Action"
                tooltip="Action"/>
              <asp:menuitem navigateurl="Drama.aspx"
                text="Drama"
                tooltip="Drama"/>
              <asp:menuitem navigateurl="Musical.aspx"
                text="Musical"
                tooltip="Musical"/>
            </asp:menuitem>
          </asp:menuitem>
        </items>
      
      </asp:menu>

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

Comentários

Use a Target propriedade para especificar a janela ou o quadro no qual exibir o conteúdo da Web vinculado a um item de menu quando esse item de menu for clicado. Os valores devem começar com uma letra no intervalo de A a Z (não diferencia maiúsculas de minúsculas), exceto para determinados valores especiais que começam com um sublinhado, conforme mostrado na tabela a seguir.

Valor de destino Descrição
_blank Renderiza o conteúdo em uma nova janela sem quadros.
_parent Renderiza o conteúdo no pai do conjunto de quadros imediato.
_search Renderiza o conteúdo no painel de pesquisa.
_self Renderiza o conteúdo no quadro com foco.
_top Renderiza o conteúdo na janela inteira sem quadros.

Observação

Verifique a documentação do navegador para determinar se há suporte para o valor _search . Por exemplo, as versões 5.0 e superiores do Internet Explorer dão suporte ao valor de _search destino

Essa propriedade se aplica a todos os itens de menu em um Menu controle. Você pode substituir essa propriedade seletivamente definindo a Target propriedade de cada MenuItem objeto diretamente.

Observação

A Target propriedade é renderizada como um atributo de destino. O atributo de destino em elementos de âncora não é permitido na definição de tipo de documento estrito XHTML 1.1. Se a saída renderizada precisar estar em conformidade com os padrões de acessibilidade ou XHTML, não defina a Target propriedade. Para obter mais informações, consulte Os Padrões XHTML em Visual Studio e ASP.NET e Acessibilidade em Visual Studio e ASP.NET.

Aplica-se a

Confira também