TreeView.OnTreeNodePopulate(TreeNodeEventArgs) Method

Definition

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)

Parameters

e
TreeNodeEventArgs

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

Remarks

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 controllo TreeView supporta il popolamento dinamico dei nodi.Because of this, the TreeView control supports dynamic node population. Quando la proprietà PopulateOnDemand per 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 di tutto la proprietà PopulateOnDemand per il nodo su true.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'evento TreeNodePopulate 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 nodo alla raccolta di ChildNodes del nodo popolato.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 alla raccolta ChildNodes di un nodo padre.A node structure is created by adding TreeNode objects to the ChildNodes collection of a parent node.

Note

Quando la proprietà PopulateOnDemand per 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 controllo TreeView di popolare in modo dinamico 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.

Notes to Inheritors

Quando si esegue l'override del metodo OnTreeNodePopulate(TreeNodeEventArgs) in una classe derivata, assicurarsi di chiamare il metodo OnTreeNodePopulate(TreeNodeEventArgs) per la classe 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.

Applies to

See also