TreeNodeBinding.Target Propriedade

Definição

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

Obtém ou define a janela ou frame de destino onde exibir o conteúdo da página Web associado a um nó ao qual o TreeNodeBinding objeto é aplicado.

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 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: Consulte a documentação do seu navegador para saber se o _search valor é suportado. Por exemplo, Microsoft Internet Explorer versão 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

Esta seção contém dois exemplos de código. O primeiro exemplo de código demonstra como usar a Target propriedade para especificar que a página Web associada ao nó raiz deve ser exibida numa nova janela. O segundo exemplo de código fornece dados XML de exemplo para o primeiro exemplo de código.

O exemplo seguinte demonstra como usar a Target propriedade para especificar que a página Web associada ao nó raiz deve ser exibida numa nova janela. Para que este exemplo funcione corretamente, deve copiar os dados XML de amostra, fornecidos após este exemplo de código, para um ficheiro chamado Book.xml.


<%@ 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>TreeNodeBinding Target Example</title>
</head>
<body>
    <form id="form1" runat="server">
    
      <h3>TreeNodeBinding Target Example</h3>
    
      <!-- Clicking the root node will navigate  -->
      <!-- the user to another page. Because the -->
      <!-- Target property is set to "_blank",   -->
      <!-- the linked page is displayed in a new -->
      <!-- window.                               -->
      <asp:TreeView id="BookTreeView" 
         DataSourceID="BookXmlDataSource"
         runat="server">
          
        <DataBindings>
          <asp:TreeNodeBinding DataMember="Book" 
            Depth="0" 
            TextField="Title"
            NavigateUrl="~\Page1.aspx"
            Target="_blank"/>
          <asp:TreeNodeBinding DataMember="Chapter" 
            Depth="1" 
            TextField="Heading"/>
          <asp:TreeNodeBinding DataMember="Appendix" 
            Depth="1" 
            TextField="Heading"/>
        </DataBindings>
         
      </asp:TreeView>
      
      <asp:XmlDataSource id="BookXmlDataSource"  
         DataFile="Book.xml"
         runat="server">
      </asp:XmlDataSource>
    
    </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>TreeNodeBinding Target Example</title>
</head>
<body>
    <form id="form1" runat="server">
    
      <h3>TreeNodeBinding Target Example</h3>
    
      <!-- Clicking the root node will navigate  -->
      <!-- the user to another page. Because the -->
      <!-- Target property is set to "_blank",   -->
      <!-- the linked page is displayed in a new -->
      <!-- window.                               -->
      <asp:TreeView id="BookTreeView" 
         DataSourceID="BookXmlDataSource"
         runat="server">
          
        <DataBindings>
          <asp:TreeNodeBinding DataMember="Book" 
            Depth="0" 
            TextField="Title"
            NavigateUrl="~\Page1.aspx"
            Target="_blank"/>
          <asp:TreeNodeBinding DataMember="Chapter" 
            Depth="1" 
            TextField="Heading"/>
          <asp:TreeNodeBinding DataMember="Appendix" 
            Depth="1" 
            TextField="Heading"/>
        </DataBindings>
         
      </asp:TreeView>
      
      <asp:XmlDataSource id="BookXmlDataSource"  
         DataFile="Book.xml"
         runat="server">
      </asp:XmlDataSource>
    
    </form>
  </body>
</html>

O exemplo de código seguinte fornece dados XML de exemplo para o exemplo de código anterior.

<Book Title="Book Title">
    <Chapter Heading="Chapter 1">
        <Section Heading="Section 1">
        </Section>
        <Section Heading="Section 2">
        </Section>
    </Chapter>
    <Chapter Heading="Chapter 2">
        <Section Heading="Section 1">
        </Section>
    </Chapter>
    <Appendix Heading="Appendix A">
    </Appendix>
</Book>

Observações

Quando o controlo TreeView está ligado a uma fonte de dados, use a Target propriedade para especificar o valor a vincular à Target propriedade de um TreeNode objeto. Esta relação de ligação afeta todos os TreeNode objetos a que o TreeNodeBinding objeto é aplicado. A Target propriedade é usada para especificar a janela ou frame em que se deve exibir o conteúdo Web que está ligado a um nó quando esse nó é clicado.

Note

Definir a Target propriedade sobrepõe-se à Target propriedade do TreeView controlo para os nós aos quais o TreeNodeBinding objeto é aplicado. Podes substituir seletivamente a Target propriedade definindo a Target propriedade de cada nó diretamente.

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 TreeNodeBinding controlo 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 Acessibilidade.

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

Aplica-se a

Ver também