TreeView.OnTreeNodePopulate(TreeNodeEventArgs) TreeView.OnTreeNodePopulate(TreeNodeEventArgs) TreeView.OnTreeNodePopulate(TreeNodeEventArgs) TreeView.OnTreeNodePopulate(TreeNodeEventArgs) Method

Definizione

Genera l'evento TreeNodePopulate del controllo TreeView.Raises the TreeNodePopulate event of the TreeView control.

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 TreeNodeEventArgs TreeNodeEventArgs

TreeNodeEventArgs in cui sono contenuti i dati dell'evento.A TreeNodeEventArgs that contains event data.

Commenti

In alcuni casi non è pratico predefinire in modo statico la struttura ad albero a causa della dimensione dei dati o del contenuto personalizzato che dipende dall'input dell'utente.Sometimes, it is not practical to statically predefine the tree structure due to data size or custom content that depends on user input. Per questo motivo, il TreeView controllo supporta il popolamento dinamico dei nodi.Because of this, the TreeView control supports dynamic node population. Quando la PopulateOnDemand proprietà di un nodo è impostata su true, il nodo viene popolato in fase di esecuzione quando il nodo è espanso.When the PopulateOnDemand property for a node is set to true, that node gets populated at run time when the node is expanded.

Per popolare un nodo in modo dinamico, impostare prima PopulateOnDemand di tutto la proprietà per trueil nodo su.To populate a node dynamically, first set the PopulateOnDemand property for the node to true. Definire quindi un metodo di gestione degli eventi per l' TreeNodePopulate evento che popola il nodo a livello di codice.Next, define an event-handling method for the TreeNodePopulate event that programmatically populates the node. Un metodo tipico di gestione degli eventi recupera i dati del nodo da un'origine dati, li inserisce in una struttura di nodi, quindi aggiunge la struttura del ChildNodes nodo alla raccolta del nodo da popolare.A typical event-handling method retrieves node data from a data source, places the data into a node structure, and then adds the node structure to the ChildNodes collection of the node being populated. Una struttura del nodo viene creata aggiungendo TreeNode oggetti ChildNodes alla raccolta di un nodo padre.A node structure is created by adding TreeNode objects to the ChildNodes collection of a parent node.

Nota

Quando la PopulateOnDemand proprietà di un nodo è impostata su true, il nodo deve essere popolato dinamicamente.When the PopulateOnDemand property for a node is set to true, the node must be populated dynamically. Non è possibile nidificare in modo dichiarativo un altro nodo sotto di esso; in caso contrario, si verificherà un errore nella pagina.You cannot declaratively nest another node below it; otherwise, an error will occur on the page.

I browser supportati (browser compatibili con Microsoft Internet Explorer 4,0 e versioni successive) possono sfruttare anche il popolamento del nodo lato client.Supported browsers (Microsoft Internet Explorer 4.0-compatible browsers and later) can also take advantage of client-side node population. Se abilitata, consente al TreeView controllo di popolare dinamicamente un nodo nel client quando tale nodo è espanso, evitando di dover eseguire il postback al server.When enabled, this allows the TreeView control to populate a node on the client dynamically when that node is expanded, which prevents the need to post back to the server. Per ulteriori informazioni sul popolamento del nodo lato client, vedere PopulateNodesFromClient.For more information on client-side node population, see PopulateNodesFromClient.

Quando viene generato un evento, il gestore dell'evento viene richiamato tramite un delegato.Raising an event invokes the event handler through a delegate. Per altre informazioni su come gestire gli eventi, vedere la gestione e generazione di eventi.For more information about how to handle events, see Handling and Raising Events.

Il metodo OnTreeNodePopulate consente inoltre alle classi derivate di gestire l'evento senza associare un delegato.The OnTreeNodePopulate method also allows derived classes to handle the event without attaching a delegate. È la tecnica consigliata per la gestione dell'evento in una classe derivata.This is the preferred technique for handling the event in a derived class.

Note per gli eredi

Quando si esegue l' OnTreeNodePopulate(TreeNodeEventArgs) override del metodo in una classe derivata, assicurarsi di chiamare OnTreeNodePopulate(TreeNodeEventArgs) il metodo per la classe di base in modo che i delegati registrati ricevano l'evento.When overriding the OnTreeNodePopulate(TreeNodeEventArgs) method in a derived class, be sure to call the OnTreeNodePopulate(TreeNodeEventArgs) method for the base class so that registered delegates receive the event.

Si applica a

Vedi anche