Inserimento dei nodi di struttura nel controllo server Web TreeView

Articolo
10/22/2014

Aggiornamento: novembre 2007

Il controllo server Web TreeView può visualizzare diversi tipi di dati: i dati statici specificati nel controllo in modo dichiarativo, i dati associati al controllo o i dati aggiunti dinamicamente al controllo TreeView in risposta alle azioni degli utenti.

Visualizzazione di dati statici

Lo schema di dati più semplice è rappresentato dai dati statici dichiarativi. Per visualizzare i dati statici avvalendosi della sintassi dichiarativa, creare un insieme di nodi figlio del controllo TreeView.

Nell'esempio riportato di seguito vengono illustrati i tag per un controllo TreeView contenente tre nodi, in due dei quali sono presenti nodi figlio.

<asp:TreeView ID="TreeView1" Runat="server">
  <Nodes>
    <asp:TreeNode Value="Parent1" Expanded="True" Text="1">
      <asp:TreeNode Value="Child1A" Text="A" />
        <asp:TreeNode Value="Child1B" Text="B" />
    </asp:TreeNode>
    <asp:TreeNode Value="Parent2" Text="2">
    </asp:TreeNode>
    <asp:TreeNode Value="Parent3" Expanded="True" Text="3">
      <asp:TreeNode Value="Child3A" Text="A">
      </asp:TreeNode>
    </asp:TreeNode>
  </Nodes>
</asp:TreeView>

Associazione a un'origine dati

Per visualizzare i dati associati al controllo in modo dichiarativo, innanzitutto aggiungere alla pagina un controllo origine dati gerarchico, ad esempio XmlDataSource, quindi assegnare a quest'ultimo una proprietà ID. Successivamente impostare la proprietà DataSourceID del controllo TreeView sull'ID del controllo origine dati. Il controllo TreeView esegue automaticamente l'associazione all'origine dati e visualizza i relativi valori.

Nota:
Il controllo TreeView può eseguire l'associazione a ogni controllo origine dati che implementa l'interfaccia IHierarchicalDataSource, quale un oggetto SiteMapDataSource o XmlDataSource.

Per impostazione predefinita, quando viene eseguita l'associazione a un'origine dati in cui ogni elemento contiene più proprietà, ad esempio un elemento XML con diversi attributi, un nodo visualizza il valore restituito dal metodo ToString dell'elemento dati. Se si tratta di un elemento XML, il nodo ne visualizza il nome. Lo schema consente di visualizzare la struttura sottostante, ma non è utile per altri scopi. È possibile associare un nodo a una determinata proprietà dell'elemento dati specificando le associazioni dei nodi della struttura tramite l'insieme DataBindings. Nell'insieme DataBindings sono contenuti oggetti TreeNodeBinding che definiscono la relazione tra un elemento dati e il nodo a cui viene associato. È possibile specificare i criteri per l'associazione e la proprietà dell'elemento dati da visualizzare nel nodo. Per ulteriori informazioni sulle associazioni di nodi di struttura, vedere TreeNodeBinding.

Nota:
Il controllo TreeView fornisce inoltre una proprietà DataSource e un metodo DataBind per l'associazione manuale dei dati.

Visualizzazione dinamica dei dati

Non è opportuno definire la struttura di dati in modo statico perché i dati potrebbero dipendere dalle informazioni raccolte in fase di esecuzione. È possibile inserire gli oggetti TreeNode in un insieme Nodes del controllo TreeView a livello di codice dal lato server oppure utilizzare la funzionalità PopulateOnDemand del controllo TreeView per inserire i nodi in modo dinamico quando il nodo padre è espanso nel client. Per ulteriori informazioni, vedere Associazione di dati al controllo server Web TreeView.