Exporter (0) Imprimer
Développer tout
Ce sujet n'a pas encore été évalué - Évaluez ce sujet

TreeNodeCollection, classe

Remarque : cette classe est nouvelle dans le .NET Framework version 2.0.

Représente une collection d'objets TreeNode dans le contrôle TreeView. Cette classe ne peut pas être héritée.

Espace de noms : System.Web.UI.WebControls
Assembly : System.Web (dans system.web.dll)

public sealed class TreeNodeCollection : ICollection, IEnumerable, IStateManager
public final class TreeNodeCollection implements ICollection, IEnumerable, 
	IStateManager
public final class TreeNodeCollection implements ICollection, IEnumerable, 
	IStateManager

La classe TreeNodeCollection est utilisée pour stocker et gérer une collection d'objets TreeNode dans le contrôle TreeView. Le contrôle TreeView utilise la classe TreeNodeCollection dans deux de ses propriétés. Il stocke ses nœuds racine dans la propriété Nodes et ses nœuds sélectionnés dans la propriété CheckedNodes. La collection TreeNodeCollection est également utilisée pour que la propriété ChildNodes stocke des nœuds enfants (dans le cas échéant).

La classe TreeNodeCollection prend en charge plusieurs modes d'accès aux éléments de la collection :

  • Utilisez l'indexeur Item pour récupérer directement un objet TreeNode à un index de base zéro spécifique.

  • Utilisez la méthode GetEnumerator afin de créer un énumérateur qui peut être utilisé pour parcourir la collection.

  • Utilisez foreach (C#) ou For Each (Visual Basic) pour parcourir la collection.

  • Utilisez la méthode CopyTo pour copier le contenu de la collection dans un objet Array.

Vous pouvez gérer par programme TreeNodeCollection en ajoutant et en supprimant des objets TreeNode. Pour ajouter des nœuds à la collection, utilisez la méthode Add ou AddAt. Pour supprimer des nœuds de la collection, utilisez la méthode Remove, RemoveAt ou Clear.

RemarqueRemarque

Lorsque le contrôle TreeView est lié à une source de données, les collections Nodes et ChildNodes sont automatiquement remplies à chaque liaison. Toutes les modifications apportées aux collections entre deux liaisons seront perdues. Pour conserver ces modifications, mettez à jour la source de données ou régénérez manuellement la collection à chaque liaison.

TreeNodeCollection contient des propriétés et des méthodes qui vous permettent de récupérer des informations concernant la collection elle-même. Pour connaître le nombre d'éléments qui existent dans la collection, utilisez la propriété Count. Si vous souhaitez déterminer si la collection contient un certain objet TreeNode, utilisez la méthode Contains. Pour obtenir l'index d'un objet TreeNode dans la collection, utilisez la méthode IndexOf.

L'exemple de code suivant montre comment ajouter par programme des nœuds à un TreeNodeCollection et comment les en retirer. Remarquez que les propriétés Nodes et ChildNodes retournent un objet TreeNodeCollection.


<%@ Page Language="C#" %>

<script runat="server">

  void Page_Load(Object sender, EventArgs e)
  {

    if (!IsPostBack)
    {

      // Use the Add and Remove methods to programmatically 
      // remove the Appendix C node and replace it with a new 
      // node. 
      LinksTreeView.Nodes.Remove(LinksTreeView.Nodes[3]);
      LinksTreeView.Nodes.Add(new TreeNode("New Appendix C"));

      // Use the AddAt and RemoveAt methods to programmatically 
      // remove the Chapter One node and replace it with a new node.
      LinksTreeView.Nodes[0].ChildNodes.RemoveAt(0);
      LinksTreeView.Nodes[0].ChildNodes.AddAt(0, new TreeNode("New Chapter One"));

      // Use the Clear method to remove all the child nodes of the 
      // Chapter Two node.
      LinksTreeView.Nodes[0].ChildNodes[1].ChildNodes.Clear();

    }

  }

</script>

<html>
  <body>
    <form runat="server">
    
      <h3>TreeNodeCollection Example</h3>
    
      <asp:TreeView id="LinksTreeView"
        Font-Name= "Arial"
        ForeColor="Blue"
        runat="server">
         
        <LevelStyles>
        
          <asp:TreeNodeStyle ChildNodesPadding="10" 
            Font-Bold="true" 
            Font-Size="12pt" 
            ForeColor="DarkGreen"/>
          <asp:TreeNodeStyle ChildNodesPadding="5" 
            Font-Bold="true" 
            Font-Size="10pt"/>
          <asp:TreeNodeStyle ChildNodesPadding="5" 
            Font-UnderLine="true" 
            Font-Size="10pt"/>
          <asp:TreeNodeStyle ChildNodesPadding="10" 
            Font-Size="8pt"/>
             
        </LevelStyles>
         
        <Nodes>
        
          <asp:TreeNode Text="Table of Contents"
            Expanded="true">
             
            <asp:TreeNode Text="Chapter One">
            
              <asp:TreeNode Text="Section 1.0">
              
                <asp:TreeNode Text="Topic 1.0.1"/>
                <asp:TreeNode Text="Topic 1.0.2"/>
                <asp:TreeNode Text="Topic 1.0.3"/>
              
              </asp:TreeNode>
              
              <asp:TreeNode Text="Section 1.1">
              
                <asp:TreeNode Text="Topic 1.1.1"/>
                <asp:TreeNode Text="Topic 1.1.2"/>
                <asp:TreeNode Text="Topic 1.1.3"/>
                <asp:TreeNode Text="Topic 1.1.4"/>
              
              </asp:TreeNode>
            
            </asp:TreeNode>
            
            <asp:TreeNode Text="Chapter Two">
            
              <asp:TreeNode Text="Section 2.0">
              
                <asp:TreeNode Text="Topic 2.0.1"/>
                <asp:TreeNode Text="Topic 2.0.2"/>
              
              </asp:TreeNode>
            
            </asp:TreeNode>
            
          </asp:TreeNode>
          
          <asp:TreeNode Text="Appendix A" />
          <asp:TreeNode Text="Appendix B" />
          <asp:TreeNode Text="Appendix C" />
        
        </Nodes>
        
      </asp:TreeView>

    </form>
  </body>
</html>


System.Object
  System.Web.UI.WebControls.TreeNodeCollection
Les membres statiques publics (Shared en Visual Basic) de ce type sont thread-safe. Il n'est pas garanti que les membres d'instance soient thread-safe.

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Édition Media Center, Windows XP Professionnel Édition x64, Windows XP SP2, Windows XP Starter Edition

Le .NET Framework ne prend pas en charge toutes les versions de chaque plate-forme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise.

.NET Framework

Prise en charge dans : 2.0
Cela vous a-t-il été utile ?
(1500 caractères restants)
Merci pour vos suggestions.

Ajouts de la communauté

AJOUTER
Afficher:
© 2014 Microsoft. Tous droits réservés.