TreeView.AutoGenerateDataBindings Propriedade

Definição

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

Recebe ou define um valor que indica se o controlo TreeView gera automaticamente ligações de nós em árvore.

public:
 property bool AutoGenerateDataBindings { bool get(); void set(bool value); };
public bool AutoGenerateDataBindings { get; set; }
member this.AutoGenerateDataBindings : bool with get, set
Public Property AutoGenerateDataBindings As Boolean

Valor de Propriedade

Boolean

true para que o TreeView controlo gere automaticamente ligações de nós em árvore; caso contrário, false. A predefinição é true.

Exemplos

Esta seção contém dois exemplos de código. O primeiro exemplo de código demonstra como desativar a geração automática de ligação de nós em árvore definindo a AutoGenerateDataBindings propriedade para false. O segundo exemplo de código fornece dados de mapa de sítios de exemplo para o primeiro exemplo de código.

O exemplo de código seguinte demonstra como desativar a geração automática de ligação de nós em árvore definindo a AutoGenerateDataBindings propriedade para false. É então definida uma DataBindings coleção para estabelecer a relação entre os itens de dados num SiteMapDataSource controlo e os nós do controlo TreeView . Para que este exemplo funcione corretamente, deve copiar os dados do mapa do local de exemplo, fornecidos após este exemplo de código, para um ficheiro chamado Web.sitemap.


<%@ 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 AutoGenerateBindings Example</title>
</head>
<body>
    <form id="form1" runat="server">
    
      <h3>TreeView AutoGenerateBindings Example</h3>
    
      <!-- Set the AutoGenerateBindings property -->
      <!-- to false declaratively to allow for   -->
      <!-- the user-defined Bindings collection. -->
      <asp:TreeView id="SiteTreeView" 
        DataSourceID="SiteMapSource"
        AutoGenerateDataBindings="False"
        runat="server">
        
        <DataBindings>
        
          <asp:TreeNodeBinding TextField="title" NavigateUrlField="url"/>
        
        </DataBindings>
            
      </asp:TreeView>
      
      <asp:SiteMapDataSource ID="SiteMapSource" runat="server"/>
         
    </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 AutoGenerateBindings Example</title>
</head>
<body>
    <form id="form1" runat="server">
    
      <h3>TreeView AutoGenerateBindings Example</h3>
    
      <!-- Set the AutoGenerateBindings property -->
      <!-- to false declaratively to allow for   -->
      <!-- the user-defined Bindings collection. -->
      <asp:TreeView id="SiteTreeView" 
        DataSourceID="SiteMapSource"
        AutoGenerateDataBindings="False"
        runat="server">
        
        <DataBindings>
        
          <asp:TreeNodeBinding TextField="title" NavigateUrlField="url"/>
        
        </DataBindings>
            
      </asp:TreeView>
      
      <asp:SiteMapDataSource ID="SiteMapSource" runat="server"/>
         
    </form>
  </body>
</html>

O seguinte exemplo de código fornece dados de mapa de sítios de exemplo para o exemplo anterior.

<siteMap>
    <siteMapNode title="Home" description="Home" url="default.aspx">
        <siteMapNode title="Products" description="Products" url="Products.aspx">
            <siteMapNode title="Computers" url="Computers.aspx"/>
            <siteMapNode title="Accessories" url="Accessories.aspx"/>
        </siteMapNode>
    </siteMapNode>
</siteMap>

Observações

As ligações de nó em árvore definem a relação entre um elemento de dados e o nó ao qual este está a ligar. Ao ligar a uma fonte de dados onde cada elemento contém múltiplas propriedades (como um elemento XML com vários atributos), o controlo TreeView precisa de saber a que propriedade de elemento de dados deve associar a que TreeNode propriedade. Se a AutoGenerateDataBindings propriedade for definida para true, o TreeView controlo gera automaticamente ligações padrão de nós em árvore que definem a Text propriedade do TreeNode objeto associado à ligação ao valor devolvido pelo ToString método do elemento de dados.

Note

As ligações de nós geradas automaticamente na árvore não são adicionadas à DataBindings coleção.

No caso de um elemento XML, o valor devolvido pelo ToString método é o nome do elemento, que mostra a estrutura subjacente do ficheiro XML, mas que não é muito útil de outra forma. Para criar uma árvore mais útil, deve definir as suas próprias ligações de nós da árvore preenchendo a DataBindings coleção.

Note

Se definires uma DataBindings coleção, o controlo TreeView usa esses valores em vez de ligações de nós em árvore geradas automaticamente.

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

Aplica-se a

Ver também