TreeNodeCollection Classe

Référence

Définition

Espace de noms:: System.Web.UI.WebControls

Assembly:: System.Web.dll

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.

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

public ref class TreeNodeCollection sealed : System::Collections::ICollection, System::Web::UI::IStateManager

public sealed class TreeNodeCollection : System.Collections.ICollection, System.Web.UI.IStateManager

type TreeNodeCollection = class
    interface ICollection
    interface IEnumerable
    interface IStateManager

Public NotInheritable Class TreeNodeCollection
Implements ICollection, IStateManager

Héritage: Object
TreeNodeCollection

Implémente: ICollection IEnumerable IStateManager

Exemples

L’exemple suivant montre comment ajouter des nœuds par programmation et les supprimer d’un TreeNodeCollection. Notez que les propriétés et ChildNodes les Nodes propriétés retournent un TreeNodeCollection objet.


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

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<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 xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>TreeNodeCollection Example</title>
</head>
<body>
    <form id="form1" runat="server">
    
      <h3>TreeNodeCollection Example</h3>
    
      <asp:TreeView id="LinksTreeView"
        Font-Names= "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>


<%@ Page Language="VB" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">

  Sub Page_Load(ByVal sender As Object, ByVal e As EventArgs)

    If Not IsPostBack Then

      ' 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()

    End If

  End Sub

</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>TreeNodeCollection Example</title>
</head>
<body>
    <form id="form1" runat="server">
    
      <h3>TreeNodeCollection Example</h3>
    
      <asp:TreeView id="LinksTreeView"
        Font-Names= "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>

Remarques

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

La TreeNodeCollection classe prend en charge plusieurs façons d’accéder aux éléments de la collection :

Utilisez l’indexeur Item[] pour récupérer un TreeNode objet directement à un index de base zéro spécifique.
Utilisez la GetEnumerator méthode pour créer un énumérateur qui peut être utilisé pour itérer au sein de la collection.
Utilisez foreach (C#) ou For Each (Visual Basic) pour itérer dans la collection.
Utilisez la CopyTo méthode pour copier le contenu de la collection dans un Array objet.

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

Notes

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

Contient TreeNodeCollection des propriétés et des méthodes qui vous permettent de récupérer des informations sur la collection elle-même. Pour savoir combien d’éléments se trouvent dans la collection, utilisez la Count propriété. Si vous souhaitez déterminer si la collection contient un certain TreeNode objet, utilisez la Contains méthode. Pour obtenir l’index d’un TreeNode objet dans la collection, utilisez la IndexOf méthode.

Constructeurs

TreeNodeCollection()	Initialise une nouvelle instance de la classe TreeNodeCollection en utilisant les valeurs par défaut.
TreeNodeCollection(TreeNode)	Initialise une nouvelle instance de la classe TreeNodeCollection à l'aide du nœud parent (ou propriétaire) spécifié.

Propriétés

Count	Obtient le nombre d'éléments dans l'objet TreeNodeCollection.
IsSynchronized	Obtient une valeur indiquant si l’accès à TreeNodeCollection est synchronisé (thread-safe).
Item[Int32]	Obtient l'objet TreeNode à l'index spécifié dans l'objet TreeNodeCollection.
SyncRoot	Obtient un objet qui peut être utilisé pour synchroniser l’accès à l’objet TreeNodeCollection.

Méthodes

Add(TreeNode)	Ajoute l'objet TreeNode spécifié à la fin de l'objet TreeNodeCollection.
AddAt(Int32, TreeNode)	Insère l'objet TreeNode spécifié dans un objet TreeNodeCollection à l'emplacement d'index spécifié.
Clear()	Vide l'objet TreeNodeCollection.
Contains(TreeNode)	Détermine si l'objet TreeNode spécifié se trouve dans la collection.
CopyTo(TreeNode[], Int32)	Copie tous les éléments de l'objet TreeNodeCollection dans un tableau d'objets TreeNode compatible unidimensionnel, en commençant à l'index spécifié dans le tableau cible.
Equals(Object)	Détermine si l'objet spécifié est égal à l'objet actuel. (Hérité de Object)
GetEnumerator()	Retourne un énumérateur qui peut être utilisé pour itérer au sein d'un objet TreeNodeCollection.
GetHashCode()	Fait office de fonction de hachage par défaut. (Hérité de Object)
GetType()	Obtient le Type de l'instance actuelle. (Hérité de Object)
IndexOf(TreeNode)	Détermine l'index de l'objet TreeNode spécifié.
MemberwiseClone()	Crée une copie superficielle du Object actuel. (Hérité de Object)
Remove(TreeNode)	Supprime l'objet TreeNode spécifié de l'objet TreeNodeCollection.
RemoveAt(Int32)	Supprime l'objet TreeNode à l'emplacement d'index spécifié de l'objet TreeNodeCollection.
ToString()	Retourne une chaîne qui représente l'objet actuel. (Hérité de Object)

Implémentations d’interfaces explicites

ICollection.CopyTo(Array, Int32)	Copie tous les éléments de l'objet TreeNodeCollection dans un tableau Array compatible unidimensionnel, en commençant à l'index spécifié dans le tableau cible.
IStateManager.IsTrackingViewState	Obtient une valeur indiquant si l'objet TreeNodeCollection enregistre les modifications apportées à son état d'affichage.
IStateManager.LoadViewState(Object)	Charge l'état d'affichage précédemment enregistré de l'objet TreeNodeCollection.
IStateManager.SaveViewState()	Enregistre les modifications apportées à l'état d'affichage dans Object.
IStateManager.TrackViewState()	Prescrit à TreeNodeCollection d'assurer le suivi des modifications apportées à son état d'affichage.

Méthodes d’extension

Cast<TResult>(IEnumerable)	Effectue un cast des éléments d'un IEnumerable vers le type spécifié.
OfType<TResult>(IEnumerable)	Filtre les éléments d'un IEnumerable en fonction du type spécifié.
AsParallel(IEnumerable)	Active la parallélisation d'une requête.
AsQueryable(IEnumerable)	Convertit un IEnumerable en IQueryable.

S’applique à