TreeView.OnTreeNodePopulate(TreeNodeEventArgs) Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Déclenche l’événement TreeNodePopulate du TreeView contrôle.
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)Paramètres
Qui TreeNodeEventArgs contient des données d’événement.
Remarques
Parfois, il n’est pas pratique de prédéfinir statiquement la structure d’arborescence en raison de la taille des données ou du contenu personnalisé qui dépend de l’entrée utilisateur. En raison de cela, le contrôle prend en charge la TreeView population dynamique des nœuds. Lorsque la PopulateOnDemand propriété d’un nœud est définie truesur , 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 truesur . 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 à partir 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 des TreeNode objets à la ChildNodes collection d’un nœud parent.
Note
Lorsque la PopulateOnDemand propriété d’un nœud est définie truesur , le nœud doit être rempli dynamiquement. Vous ne pouvez pas imbriquer de manière déclarative un autre nœud sous 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 des nœuds côté client. Lorsque cette option est activée, le TreeView contrôle permet au contrôle de remplir dynamiquement un nœud sur le client lorsque ce nœud est développé, ce qui empêche la publication sur le serveur. Pour plus d’informations sur la population des nœuds côté client, consultez PopulateNodesFromClient.
Le déclenchement d’un événement appelle le gestionnaire d’événements par le biais d’un délégué. Pour plus d’informations sur la gestion des événements, consultez Gestion et déclenchement d’événements.
La OnTreeNodePopulate méthode permet également aux classes dérivées de gérer l’événement sans attacher de délégué. Il s’agit de la technique recommandée pour gérer l’événement dans une classe dérivée.
Notes pour les héritiers
En cas de substitution de la OnTreeNodePopulate(TreeNodeEventArgs) méthode dans une classe dérivée, veillez à appeler la OnTreeNodePopulate(TreeNodeEventArgs) méthode pour la classe de base afin que les délégués inscrits reçoivent l’événement.
