Sélection, navigation et cases à cocher dans le contrôle serveur Web TreeView
Mise à jour : novembre 2007
Le contrôle TreeView ASP.NET vous permet de répondre facilement lorsqu'un utilisateur clique sur un nœud ou de modifier le comportement d'un nœud pour le faire agir comme un lien hypertexte. En outre, vous pouvez utiliser le contrôle TreeView pour afficher des cases à cocher en regard de nœuds individuels afin que les utilisateurs puissent sélectionner plusieurs nœuds à la fois.
Sélection et navigation
Chaque nœud a une propriété Text et une propriété Value. La valeur de la propriété Text est affichée dans le contrôle TreeView, tandis que la propriété Value sert à stocker des données supplémentaires relatives au nœud, telles que les données passées à l'événement de publication qui est associé au nœud.
Lorsqu'un utilisateur clique sur un nœud du contrôle TreeView, ce nœud peut soit déclencher un événement de sélection (via la publication), soit afficher une autre page. Lorsque la propriété href n'est pas définie, cliquer sur un nœud déclenche un événement SelectedNodeChanged qui peut être géré pour fournir des fonctionnalités personnalisées. Vous pouvez également vérifier la propriété Selected d'un nœud pour déterminer s'il est sélectionné ou non. L'affectation de la valeur true à cette propriété ou l'appel de la méthode Select sur le nœud entraîne la sélection par programme de ce nœud.
Chaque nœud a également une propriété SelectAction qui peut être utilisée pour spécifier les actions qui se produisent lorsqu'un utilisateur clique sur le nœud, comme le développement ou la réduction du nœud. Au lieu de déclencher un événement SelectedNodeChanged pour afficher une autre page lorsqu'un utilisateur clique sur un nœud, affectez à la propriété href du nœud une valeur autre qu'une chaîne vide ("").
Pour plus d'informations sur la gestion d'événements de sélection, consultez SelectedNode. Pour plus d'informations sur le mode navigation, consultez href. Pour plus d'informations sur la définition de la propriété href lors de la liaison de données, consultez hrefField.
Cases à cocher
Dans les cas où vous souhaitez permettre aux utilisateurs de sélectionner plusieurs nœuds, vous pouvez utiliser le contrôle TreeView pour afficher une case à cocher en regard d'une image de nœud. Lorsqu'une valeur TreeNodeType autre que TreeNodeType.None est affectée à la propriété ShowCheckBoxes, des cases à cocher sont affichées en regard des nœuds spécifiés. Lorsque des cases à cocher sont affichées, vous pouvez utiliser l'événement TreeNodeCheckChanged pour exécuter votre routine personnalisée dès que l'état d'une case à cocher change entre les publications sur le serveur. À la prochaine publication de la page sur le serveur, la propriété CheckedNodes est remplie avec les nœuds sélectionnés.
Le contrôle TreeView n'expose pas de propriété AutoPostBack. Ainsi, pour envoyer des sélections de case à cocher, vous devez placer un contrôle, comme un contrôle serveur Web Button, sur la page pour publier des informations sur le serveur.
Pour plus d'informations sur l'utilisation de cases à cocher avec le contrôle TreeView ASP.NET, consultez CheckBoxes.
Voir aussi
Concepts
Remplissage des nœuds de l'arbre dans le contrôle serveur Web TreeView