TreeView.AutoGenerateDataBindings Proprietà

  • Riferimento

Definizione

Spazio dei nomi:
System.Web.UI.WebControls
Assembly:
System.Web.dll

Ottiene o imposta un valore che indica se il controllo TreeView genera in modo automatico associazioni di nodi della struttura ad albero.

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à

Boolean

true per consentire al controllo TreeView di generare in modo automatico associazioni di nodi della struttura ad albero; in caso contrario, false. Il valore predefinito è true.

Esempio

In questa sezione sono riportati due esempi di codice. Nel primo esempio di codice viene illustrato come disabilitare la generazione automatica dell'associazione di nodi della struttura ad albero impostando la AutoGenerateDataBindings proprietà su false. Il secondo esempio di codice fornisce i dati della mappa del sito di esempio per il primo esempio di codice.

Nell'esempio di codice seguente viene illustrato come disabilitare la generazione automatica dell'associazione di nodi della struttura ad albero impostando la AutoGenerateDataBindings proprietà su false. Viene quindi definita una DataBindings raccolta per stabilire la relazione tra gli elementi di dati in un SiteMapDataSource controllo e i nodi del TreeView controllo. 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.


<%@ 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 della mappa del sito di esempio per l'esempio precedente.

<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 di nodi della struttura ad albero definiscono la relazione tra un elemento di dati e il nodo a cui è a livello di associazione. Quando si esegue il binding a un'origine dati in cui ogni elemento di dati contiene più proprietà, ad esempio un elemento XML con diversi attributi, il TreeView controllo deve conoscere la proprietà dell'elemento di dati da associare a quale TreeNode proprietà. Se la AutoGenerateDataBindings proprietà è impostata su true, il TreeView controllo genera automaticamente associazioni di nodi struttura ad albero predefinite che impostano la Text proprietà dell'oggetto TreeNode associato all'associazione al valore restituito dal ToString metodo dell'elemento di dati.

Nota

Le associazioni dei nodi della struttura ad albero generate automaticamente non vengono aggiunte alla DataBindings raccolta.

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. Per creare un albero più utile, è necessario definire associazioni di nodi dell'albero personalizzate popolando la DataBindings raccolta.

Nota

Se si definisce una DataBindings raccolta, il TreeView controllo utilizza tali valori anziché le associazioni dei nodi della struttura ad albero generate automaticamente.

Il valore di questa proprietà viene archiviato nello stato di visualizzazione.

Si applica a

Vedi anche