Compartilhar via

TreeView.Target Propriedade

Definição

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

Obtém ou define a janela de destino ou o quadro no qual exibir o conteúdo da página da Web associado a um nó.

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 o quadro no qual exibir o conteúdo da página da Web vinculado. 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 Renderiza o conteúdo em
_blank Uma nova janela sem quadros.
_parent O pai do conjunto de quadros imediato.
_search O painel de pesquisa.
_self O quadro com foco.
_top A janela completa sem quadros.

Observação: verifique a documentação do navegador para determinar se o _search valor tem suporte. Por exemplo, o Microsoft Internet Explorer 5.0 e posterior dá suporte ao valor de _search destino.

O padrão é uma cadeia de caracteres vazia (""), que atualiza a janela ou quadro com foco.

Exemplos

O exemplo de código a seguir demonstra como usar a Target propriedade para exibir o conteúdo da Web vinculado a um nó em uma nova janela quando esse nó é 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>TreeView Target Example</title>
</head>
<body>
    <form id="form1" runat="server">
    
      <h3>TreeView Target Example</h3>
      
      <asp:TreeView id="LinksTreeView"
         Target="_blank" 
         runat="server">
         
        <Nodes>
        
          <asp:TreeNode Value="Home" 
            NavigateUrl="Home.aspx" 
            Text="Home"
            Expanded="True">
             
            <asp:TreeNode Value="Page 1" 
              NavigateUrl="Page1.aspx" 
              Text="Page1">
               
              <asp:TreeNode Value="Section 1" 
                NavigateUrl="Section1.aspx" 
                Text="Section 1"/>
                 
            </asp:TreeNode>              
            
            <asp:TreeNode Value="Page 2" 
              NavigateUrl="Page2.aspx"
              Text="Page 2">
               
            </asp:TreeNode> 
            
          </asp:TreeNode>
        
        </Nodes>
        
      </asp:TreeView>

    </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>TreeView Target Example</title>
</head>
<body>
    <form id="form1" runat="server">
    
      <h3>TreeView Target Example</h3>
      
      <asp:TreeView id="LinksTreeView"
         Target="_blank" 
         runat="server">
         
        <Nodes>
        
          <asp:TreeNode Value="Home" 
            NavigateUrl="Home.aspx" 
            Text="Home"
            Expanded="True">
             
            <asp:TreeNode Value="Page 1" 
              NavigateUrl="Page1.aspx" 
              Text="Page1">
               
              <asp:TreeNode Value="Section 1" 
                NavigateUrl="Section1.aspx" 
                Text="Section 1"/>
                 
            </asp:TreeNode>              
            
            <asp:TreeNode Value="Page 2" 
              NavigateUrl="Page2.aspx"
              Text="Page 2">
               
            </asp:TreeNode> 
            
          </asp:TreeNode>
        
        </Nodes>
        
      </asp:TreeView>

    </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 nó quando esse nó for clicado.

Observação

A Target propriedade é renderizada como um target atributo. O target atributo em 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 for compatível com XHTML TreeView 1.1. Para obter mais informações, consulte XHTML Standards no Visual Studio e ASP.NET.

Ao criar páginas da Web acessíveis, você deve evitar usar a Target propriedade para direcionar outra janela. Para obter mais informações, consulte ASP.NET Controles e Acessibilidade.

O valor dessa propriedade é armazenado no estado de exibição.

Aplica-se a

Confira também