TreeView.AutoGenerateDataBindings 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 um valor que indica se o controle TreeView gera automaticamente as associações de nó de á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 da propriedade

Boolean

true para que o TreeView controle gere automaticamente associações de nó de árvore; caso contrário, false. O padrão é true.

Exemplos

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

O exemplo de código a seguir demonstra como desabilitar a geração automática de associação de nó de árvore definindo a AutoGenerateDataBindings propriedade como false. Uma DataBindings coleção é então definida para estabelecer a relação entre os itens de dados em um SiteMapDataSource controle e os nós do TreeView controle. Para que este exemplo funcione corretamente, você deve copiar os dados do mapa do site de exemplo, fornecidos após este exemplo de código, para um arquivo 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 exemplo de código a seguir fornece dados de mapa de site 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>

Comentários

As associações de nó de árvore definem a relação entre um item de dados e o nó ao qual ele está associando. Ao associar a uma fonte de dados em que cada item de dados contém várias propriedades (como um elemento XML com vários atributos), o TreeView controle precisa saber qual propriedade de item de dados associar a qual TreeNode propriedade. Se a AutoGenerateDataBindings propriedade for definida como true, o TreeView controle gerará automaticamente associações de nó de árvore padrão que definem a Text propriedade do TreeNode objeto associada à associação ao valor retornado pelo ToString método do item de dados.

Observação

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

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

Observação

Se você definir uma DataBindings coleção, o TreeView controle usará esses valores em vez de associações de nó de árvore geradas automaticamente.

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

Aplica-se a

Partilhar via