Remplissage des nœuds de l'arbre dans le contrôle serveur Web TreeView

Article
10/22/2014

Mise à jour : novembre 2007

Le contrôle serveur Web TreeView peut afficher plusieurs types de données : données statiques spécifiées de façon déclarative dans le contrôle, données liées au contrôle ou données ajoutées de manière dynamique au contrôle TreeView en réponse aux actions de l'utilisateur.

Affichage de données statiques

Les données statiques déclaratives constituent le schéma de données le plus simple. Pour afficher les données statiques à l'aide d'une syntaxe déclarative, créez une collection de nœuds qui sont des enfants du contrôle TreeView.

L'exemple suivant affiche le balisage d'un contrôle TreeView contenant trois nœuds dont deux possèdent des nœuds enfants.

<asp:TreeView ID="TreeView1" Runat="server">
  <Nodes>
    <asp:TreeNode Value="Parent1" Expanded="True" Text="1">
      <asp:TreeNode Value="Child1A" Text="A" />
        <asp:TreeNode Value="Child1B" Text="B" />
    </asp:TreeNode>
    <asp:TreeNode Value="Parent2" Text="2">
    </asp:TreeNode>
    <asp:TreeNode Value="Parent3" Expanded="True" Text="3">
      <asp:TreeNode Value="Child3A" Text="A">
      </asp:TreeNode>
    </asp:TreeNode>
  </Nodes>
</asp:TreeView>

Liaison à une source de données

Pour afficher des données liées de manière déclarative au contrôle, commencez par ajouter un contrôle de source de données hiérarchique, par exemple le contrôle XmlDataSource, à la page et affectez-lui un élément ID. Ensuite, affectez à la propriété DataSourceID du contrôle TreeView l'élément ID du contrôle de source de données. Le contrôle TreeView peut automatiquement être lié à la source de données et afficher ses valeurs.

Remarque :
Le contrôle TreeView peut être lié à n'importe quel contrôle de source de données qui implémente l'interface IHierarchicalDataSource, par exemple un objet SiteMapDataSource ou un objet XmlDataSource.

Par défaut, lorsque vous effectuez une liaison à une source de données où chaque élément de données contient plusieurs propriétés (tel qu'un élément XML avec plusieurs attributs), un nœud affiche la valeur retournée par la méthode ToString de l'élément de données. Dans le cas d'un élément XML, le nœud affiche le nom de l'élément. Ce schéma affiche la structure sous-jacente de l'arborescence, mais n'est pas pour autant très utile. Vous pouvez lier un nœud à une propriété d'élément de données spécifique en déterminant des liaisons de nœud d'arbre à l'aide de la collection DataBindings. La collection DataBindings contient des objets TreeNodeBinding qui définissent la relation entre un élément de données et le nœud auquel il est lié. Vous pouvez spécifier les critères de liaison et la propriété de l'élément de données à afficher dans le nœud. Pour plus d'informations sur les liaisons de nœud d'arbre, consultez TreeNodeBinding.

Remarque :
Le contrôle TreeView fournit également une propriété DataSource et une méthode DataBind pour une liaison de données manuelle.

Affichage dynamique de données

Il peut ne pas être pratique de définir vos structures de données de manière statique, sinon les données peuvent dépendre des informations que vous recueillez au moment de l'exécution. Vous pouvez remplir par programme les objets TreeNode de la collection Nodes d'un contrôle TreeViewdans un code côté serveur ou utiliser la fonction PopulateOnDemand du contrôle TreeView pour remplir des nœuds de manière dynamique lorsque le nœud parent est développé sur le client. Pour plus d'informations, consultez Liaison de données au contrôle serveur Web TreeView.