TreeView.OnTreeNodePopulate(TreeNodeEventArgs) Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Genera l'evento TreeNodePopulate del controllo TreeView.
protected:
virtual void OnTreeNodePopulate(System::Web::UI::WebControls::TreeNodeEventArgs ^ e);protected virtual void OnTreeNodePopulate (System.Web.UI.WebControls.TreeNodeEventArgs e);abstract member OnTreeNodePopulate : System.Web.UI.WebControls.TreeNodeEventArgs -> unit
override this.OnTreeNodePopulate : System.Web.UI.WebControls.TreeNodeEventArgs -> unitProtected Overridable Sub OnTreeNodePopulate (e As TreeNodeEventArgs)Parametri
TreeNodeEventArgs in cui sono contenuti i dati dell'evento.
Commenti
In alcuni casi, non è pratico definire in modo statico la struttura ad albero a causa delle dimensioni dei dati o del contenuto personalizzato che dipende dall'input dell'utente. Per questo motivo, il controllo supporta il TreeView popolamento di nodi dinamici. Quando la PopulateOnDemand proprietà per un nodo è impostata su true, il nodo viene popolato in fase di esecuzione quando il nodo viene espanso.
Per popolare un nodo in modo dinamico, impostare prima la PopulateOnDemand proprietà per il nodo su true. Definire quindi un metodo di gestione degli eventi per l'evento TreeNodePopulate che popola a livello di codice il nodo. Un metodo tipico di gestione degli eventi recupera i dati dei nodi da un'origine dati, inserisce i dati in una struttura di nodo e quindi aggiunge la struttura del nodo alla ChildNodes raccolta del nodo popolato. Una struttura di nodo viene creata aggiungendo TreeNode oggetti alla ChildNodes raccolta di un nodo padre.
Nota
Quando la PopulateOnDemand proprietà per un nodo è impostata su true, il nodo deve essere popolato in modo dinamico. Non è possibile annidare in modo dichiarativo un altro nodo sotto di esso; in caso contrario, si verificherà un errore nella pagina.
I browser supportati (browser compatibili con Microsoft Internet Explorer 4.0 e versioni successive) possono anche sfruttare il popolamento di nodi lato client. Se abilitata, questo consente al TreeView controllo di popolare dinamicamente un nodo nel client quando tale nodo viene espanso, impedendo così la necessità di eseguire il postback al server. Per altre informazioni sul popolamento di nodi lato client, vedere PopulateNodesFromClient.
Quando viene generato un evento, il gestore dell'evento viene richiamato tramite un delegato. Per altre informazioni su come gestire gli eventi, vedere la gestione e generazione di eventi.
Il metodo OnTreeNodePopulate consente inoltre alle classi derivate di gestire l'evento senza associare un delegato. È la tecnica consigliata per la gestione dell'evento in una classe derivata.
Note per gli eredi
Quando si esegue l'override del OnTreeNodePopulate(TreeNodeEventArgs) metodo in una classe derivata, assicurarsi di chiamare il OnTreeNodePopulate(TreeNodeEventArgs) metodo per la classe base in modo che i delegati registrati ricevano l'evento.
