TreeView.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 para exibir o conteúdo da página 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 de Propriedade

String

A janela ou frame alvo onde é exibido o conteúdo da página Web ligada. Os valores 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 Renderiza o conteúdo em
_blank Uma janela nova sem molduras.
_parent O pai imediato do frameset.
_search O painel de pesquisa.
_self O enquadramento com foco.
_top A janela inteira sem molduras.

Nota: Consulte a documentação do seu navegador para saber se o _search valor é suportado. Por exemplo, Microsoft Internet Explorer 5.0 e posteriores suportam o valor alvo _search.

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

Exemplos

O exemplo de código seguinte demonstra como usar a Target propriedade para mostrar o conteúdo Web que está ligado a um nó numa 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>

Observações

Use a Target propriedade para especificar a janela ou frame em que deve ser exibido o conteúdo Web que está ligado a um nó quando esse nó é clicado.

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 para o TreeView tiver de ser 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, deve evitar usar a Target propriedade para direcionar outra janela. Para mais informações, consulte ASP.NET Controlos e Acessibilidade.

O valor desta propriedade é armazenado no estado de visualização.

Aplica-se a

Ver também