TreeNodeBinding.Target Propriedade

Referência

Definição

Namespace:: System.Web.UI.WebControls

Assembly:: System.Web.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Obtém ou define a janela ou o quadro de destino no qual exibir o conteúdo da página da Web associada a um nó ao qual o objeto TreeNodeBinding é 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 da propriedade

String

A janela de destino ou quadro no qual exibir o conteúdo da página da Web vinculada. 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 _search valor. Por exemplo, o Microsoft Internet Explorer versão 5.0 e posterior dá suporte ao _search valor de destino.

O padrão é uma cadeia de caracteres vazia (""), que atualiza a janela ou quadro 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 da Web associada ao nó raiz deve ser exibida em uma nova janela. O segundo exemplo de código fornece dados XML de exemplo para o primeiro exemplo de código.

O exemplo a seguir demonstra como usar a Target propriedade para especificar que a página da Web associada ao nó raiz deve ser exibida em uma nova janela. Para que este exemplo funcione corretamente, você deve copiar os dados XML de exemplo, fornecidos após este exemplo de código, para um arquivo 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 a seguir 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>

Comentários

Quando o TreeView controle estiver associado a uma fonte de dados, use a Target propriedade para especificar o valor a ser associado à Target propriedade de um TreeNode objeto . Essa relação de associação afeta todos os TreeNode objetos aos quais o TreeNodeBinding objeto é aplicado. A Target propriedade é usada para especificar a janela ou quadro no qual o conteúdo da Web está vinculado a um nó quando esse nó é clicado.

Observação

Definir a Target propriedade substitui a Target propriedade do TreeView controle para os nós aos quais o TreeNodeBinding objeto é aplicado. Você pode substituir seletivamente a Target propriedade definindo a Target propriedade de cada nó diretamente.

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 para o TreeNodeBinding controle precisar ser compatível com XHTML 1.1. Para obter mais informações, confira Padrões XHTML 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 Acessibilidade.

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

Aplica-se a

Partilhar via