Selezione, spostamento e caselle di controllo nel controllo server Web TreeView
Aggiornamento: novembre 2007
Il controllo ASP.NET TreeView consente di rispondere al clic di un utente su un nodo o di modificare il comportamento di un nodo in modo che funzioni come un collegamento ipertestuale. È inoltre possibile utilizzare il controllo TreeView per visualizzare le caselle di controllo accanto ai singoli nodi, in modo da consentire agli utenti di selezionare più nodi contemporaneamente.
Selezione e spostamento
A ciascun nodo è assegnata una proprietà Text e una proprietà Value. Il valore della proprietà Text viene visualizzato nel controllo TreeView, mentre la proprietà Value viene utilizzata per memorizzare i dati aggiuntivi relativi al nodo, ad esempio quelli passati all'evento di postback associato al nodo.
Quando viene fatto clic su un nodo del controllo TreeView, quest'ultimo può generare un evento di selezione (tramite postback) o il passaggio a un'altra pagina. Se la proprietà href non è impostata, la selezione di un nodo genera un evento SelectedNodeChanged che è possibile gestire per fornire funzionalità personalizzate. È possibile anche controllare la proprietà Selected di un nodo per verificare se è selezionato. L'impostazione di questa proprietà su true o la chiamata al metodo Select sul nodo determinerà la selezione del nodo a livello di codice.
A ciascun nodo è inoltre assegnata una proprietà SelectAction che consente di specificare le azioni che si verificano quando viene fatto clic su di esso, quali l'espansione o la compressione del nodo. Anziché generare un evento SelectedNodeChanged per passare a un'altra pagina quando viene fatto clic su un nodo, impostare la proprietà href del nodo su un valore diverso da una stringa vuota ("").
Per ulteriori informazioni sulla gestione degli eventi di selezione, vedere SelectedNode. Per ulteriori informazioni sulla modalità di spostamento, vedere href. Per ulteriori informazioni sull'impostazione della proprietà href durante l'associazione di dati, vedere hrefField.
Caselle di controllo
Se si desidera consentire agli utenti di selezionare più nodi, è possibile utilizzare il controllo TreeView per visualizzare una casella di controllo accanto all'immagine di un nodo. Quando la proprietà ShowCheckBoxes è impostata su un TreeNodeType diverso da TreeNodeType.None, accanto ai nodi specificati vengono visualizzate le caselle di controllo. In tal caso, è possibile utilizzare l'evento TreeNodeCheckChanged per eseguire una routine personalizzata ogni volta che lo stato di una casella di controllo cambia nel periodo compreso tra due invii consecutivi al server. Al successivo invio della pagina al server, i nodi selezionati vengono inseriti nella proprietà CheckedNodes.
Il controllo TreeView non espone una proprietà AutoPostBack. Di conseguenza, per inviare le selezioni relative alle caselle di controllo, è necessario inserire nella pagina un controllo, ad esempio un controllo server Web Button, per eseguire il postback delle informazioni al server.
Per ulteriori informazioni sull'utilizzo di caselle di controllo con il controllo ASP.NET TreeView, vedere CheckBoxes.
Vedere anche
Concetti
Inserimento dei nodi di struttura nel controllo server Web TreeView