TreeView.AutoGenerateDataBindings TreeView.AutoGenerateDataBindings TreeView.AutoGenerateDataBindings TreeView.AutoGenerateDataBindings Property

Definizione

Ottiene o imposta un valore che indica se il controllo TreeView genera in modo automatico associazioni di nodi della struttura ad albero.Gets or sets a value indicating whether the TreeView control automatically generates tree node bindings.

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

Valore della proprietà

true per consentire al controllo TreeView di generare in modo automatico associazioni di nodi della struttura ad albero; in caso contrario, false.true to have the TreeView control automatically generate tree node bindings; otherwise, false. Il valore predefinito è true.The default is true.

Esempi

In questa sezione sono riportati due esempi di codice.This section contains two code examples. Nel primo esempio di codice viene illustrato come disabilitare la generazione automatica di associazioni di nodi AutoGenerateDataBindings della struttura falsead albero impostando la proprietà su.The first code example demonstrates how to disable automatic tree node binding generation by setting the AutoGenerateDataBindings property to false. Il secondo esempio di codice fornisce dati della mappa del sito di esempio per il primo esempio di codice.The second code example provides sample site map data for the first code example.

Nell'esempio di codice seguente viene illustrato come disabilitare la generazione automatica di associazioni di nodi AutoGenerateDataBindings della struttura falsead albero impostando la proprietà su.The following code example demonstrates how to disable automatic tree node binding generation by setting the AutoGenerateDataBindings property to false. Viene DataBindings quindi definita una raccolta per stabilire la relazione tra gli elementi di dati in SiteMapDataSource un controllo TreeView e i nodi del controllo.A DataBindings collection is then defined to establish the relationship between the data items in a SiteMapDataSource control and the nodes of the TreeView control. Per il corretto funzionamento di questo esempio, è necessario copiare i dati della mappa del sito di esempio, forniti dopo questo esempio di codice, in un file denominato Web. sitemap.For this example to work correctly, you must copy the sample site map data, provided after this code example, to a file named 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>

Nell'esempio di codice seguente vengono forniti i dati di esempio della mappa del sito per l'esempio precedente.The following code example provides sample site map data for the preceding example.

<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>  

Commenti

Le associazioni del nodo della struttura ad albero definiscono la relazione tra un elemento di dati e il nodo a cui è associato.Tree node bindings define the relationship between a data item and the node it is binding to. Quando si esegue l'associazione a un'origine dati in cui ogni elemento dati contiene più proprietà (ad esempio un elemento XML con diversi TreeView attributi), il controllo deve stabilire quale proprietà dell'elemento dati TreeNode associare alla proprietà.When binding to a data source where each data item contains multiple properties (such as an XML element with several attributes), the TreeView control needs to know which data item property to bind to which TreeNode property. Se la AutoGenerateDataBindings proprietà è impostata su true, il TreeView controllo genera automaticamente TreeNode associazioni di nodi della struttura ad albero predefinite Text che impostano la proprietà dell'oggetto associato all'associazione al valore restituito dal ToString metodo dell'elemento di dati.If the AutoGenerateDataBindings property is set to true, the TreeView control automatically generates default tree node bindings that set the Text property of the TreeNode object that is associated with the binding to the value that is returned by the ToString method of the data item.

Nota

Le associazioni del nodo dell'albero generate automaticamente non vengono aggiunte DataBindings alla raccolta.The automatically generated tree node bindings are not added to the DataBindings collection.

Nel caso di un elemento XML, il valore restituito dal ToString metodo è il nome dell'elemento, che mostra la struttura sottostante del file XML, ma non è molto utile in caso contrario.In the case of an XML element, the value that is returned by the ToString method is the element name, which shows the underlying structure of the XML file, but is not very useful otherwise. Per creare un albero più utile, è necessario definire le associazioni del nodo della struttura ad albero popolando la DataBindings raccolta.To create a more useful tree, you must define your own tree node bindings by populating the DataBindings collection.

Nota

Se si definisce una DataBindings raccolta, il TreeView controllo utilizza tali valori anziché le associazioni del nodo della struttura ad albero generate automaticamente.If you define a DataBindings collection, the TreeView control uses those values instead of automatically generated tree node bindings.

Il valore di questa proprietà viene archiviato nello stato di visualizzazione.The value of this property is stored in view state.

Si applica a

Vedi anche