TreeNode.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 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 e 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.

Nota: Verifique 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 valor padrão é uma cadeia vazia (""), que atualiza a janela ou frame com o foco.

Exemplos

O seguinte exemplo de código demonstra como configurar os frames para o próximo exemplo.


<html xmlns="http://www.w3.org/1999/xhtml">
<head>
    <title>TreeView Frameset Example</title>
</head>
         
    <frameset cols="30%, 75%">
   
        <frame title="MenuFrame" name="Menu" src="TreeViewFramecs.aspx"/>
        <frame title="ContentFrame" name="Content" src="Home.aspx"/> 
           
    </frameset>      
   
</html>


<html xmlns="http://www.w3.org/1999/xhtml">
<head>
    <title>TreeView Frameset Example</title>
</head>
         
    <frameset cols="30%, 75%">
   
        <frame title="MenuFrame" name="Menu" src="TreeViewFramevb.aspx"/>
        <frame title="ContentFrame" name="Content" src="Home.aspx"/> 
           
    </frameset>      
   
</html>

O exemplo de código seguinte demonstra como usar a Target propriedade para especificar o frame em que mostrar o conteúdo ligado. Este exemplo é usado dentro do conjunto de frames do exemplo anterior para apresentar um índice.


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

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

Observações

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

Note

Definir esta propriedade sobrepõe-se à Target propriedade do TreeView controlo.

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 TreeNode objeto 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, recomenda-se vivamente que evite usar a Target propriedade para direcionar outra janela. Para mais informações, consulte ASP.NET Acessibilidade.

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

Aplica-se a

Ver também