TreeView.OnTreeNodePopulate(TreeNodeEventArgs) Méthode

Définition

Déclenche l'événement TreeNodePopulate du contrôle 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)

Paramètres

e
TreeNodeEventArgs

TreeNodeEventArgs qui contient des données d’événement.

Remarques

Parfois, il n’est pas pratique de prédéfinir statiquement l’arborescence en raison de la taille des données ou du contenu personnalisé qui dépend de l’entrée utilisateur. Pour cette raison, le contrôle prend en charge la TreeView population de nœuds dynamiques. Lorsque la PopulateOnDemand propriété d’un nœud est définie sur true, ce nœud est rempli au moment de l’exécution lorsque le nœud est développé.

Pour remplir un nœud dynamiquement, définissez d’abord la PopulateOnDemand propriété du nœud sur true. Ensuite, définissez une méthode de gestion des événements pour l’événement TreeNodePopulate qui remplit par programmation le nœud. Une méthode de gestion des événements classique récupère les données de nœud d’une source de données, place les données dans une structure de nœud, puis ajoute la structure de nœud à la ChildNodes collection du nœud en cours de remplissage. Une structure de nœud est créée en ajoutant TreeNode des objets à la ChildNodes collection d’un nœud parent.

Notes

Lorsque la PopulateOnDemand propriété d’un nœud est définie sur true, le nœud doit être renseigné dynamiquement. Vous ne pouvez pas imbriquer de manière déclarative un autre nœud en dessous de celui-ci ; sinon, une erreur se produit sur la page.

Les navigateurs pris en charge (navigateurs compatibles avec Microsoft Internet Explorer 4.0 et versions ultérieures) peuvent également tirer parti de la population de nœuds côté client. Lorsqu’il est activé, cela permet au TreeView contrôle de remplir dynamiquement un nœud sur le client lorsque ce nœud est développé, ce qui évite d’avoir à effectuer une publication sur le serveur. Pour plus d’informations sur la population de nœuds côté client, consultez PopulateNodesFromClient.

Le déclenchement d'un événement appelle le gestionnaire des événements par l'intermédiaire d'un délégué. Pour plus d’informations sur la façon de gérer les événements, consultez gestion et déclenchement d’événements.

La méthode OnTreeNodePopulate permet également aux classes dérivées de gérer l'événement sans y attacher de délégué. Il s'agit de la méthode recommandée pour gérer l'événement dans une classe dérivée.

Notes pour les héritiers

Lorsque vous remplacez la OnTreeNodePopulate(TreeNodeEventArgs) méthode dans une classe dérivée, veillez à appeler la méthode pour la OnTreeNodePopulate(TreeNodeEventArgs) classe de base afin que les délégués inscrits reçoivent l’événement.

S’applique à

Voir aussi