Condividi tramite


TreeView.OnTreeNodePopulate(TreeNodeEventArgs) Metodo

Definizione

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 -> unit
Protected Overridable Sub OnTreeNodePopulate (e As TreeNodeEventArgs)

Parametri

e
TreeNodeEventArgs

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.

Si applica a

Vedi anche