TreeView.AutoGenerateDataBindings Property

Definition

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

Property Value

Boolean

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.

Examples

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 della struttura ad albero impostando la proprietà AutoGenerateDataBindings su false.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 della struttura ad albero impostando la proprietà AutoGenerateDataBindings su false.The following code example demonstrates how to disable automatic tree node binding generation by setting the AutoGenerateDataBindings property to false. Viene quindi definita una raccolta di DataBindings per stabilire la relazione tra gli elementi di dati in un controllo SiteMapDataSource e i nodi del controllo TreeView.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>

Remarks

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 attributi), il controllo TreeView deve stabilire quale proprietà dell'elemento dati associare a quale TreeNode 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 proprietà AutoGenerateDataBindings è impostata su true, il controllo TreeView genera automaticamente associazioni di nodi della struttura ad albero predefinite che impostano la proprietà Text dell'oggetto TreeNode associato all'associazione al valore restituito dal metodo ToString dell'elemento 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.

Note

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

Nel caso di un elemento XML, il valore restituito dal metodo ToString è 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 raccolta di DataBindings.To create a more useful tree, you must define your own tree node bindings by populating the DataBindings collection.

Note

Se si definisce una raccolta di DataBindings, il controllo TreeView 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.

Applies to

See also