TreeNodeCollection Classe

Définition

Représente une collection d’objets TreeNode dans le contrôle TreeView .Represents a collection of TreeNode objects in the TreeView control. Cette classe ne peut pas être héritée.This class cannot be inherited.

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
TreeNodeCollection
Implémente

Exemples

L’exemple suivant montre comment ajouter par programmation des nœuds à et les supprimer d’un TreeNodeCollection.The following example demonstrates how to programmatically add nodes to and remove them from a TreeNodeCollection. Notez que les Nodes propriétés ChildNodes et retournent un TreeNodeCollection objet.Notice that the Nodes and ChildNodes properties return a TreeNodeCollection object.


<%@ 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' TreeNode objets dans le TreeView contrôle.The TreeNodeCollection class is used to store and manage a collection of TreeNode objects in the TreeView control. Le TreeView contrôle utilise la TreeNodeCollection classe dans deux de ses propriétés.The TreeView control uses the TreeNodeCollection class in two of its properties. Il stocke ses nœuds racine Nodes dans la propriété et ses nœuds CheckedNodes sélectionnés dans la propriété.It stores its root nodes in the Nodes property and its selected nodes in the CheckedNodes property. La TreeNodeCollection collection est également utilisée pour que ChildNodes la propriété stocke les nœuds enfants (le cas échéant).The TreeNodeCollection collection is also used for the ChildNodes property to store child nodes (if any).

La TreeNodeCollection classe prend en charge plusieurs façons d’accéder aux éléments de la collection:The TreeNodeCollection class supports several ways to access the items in the collection:

  • Utilisez l' Item[Int32] indexeur pour récupérer un TreeNode objet directement à un index de base zéro spécifique.Use the Item[Int32] indexer to retrieve a TreeNode object directly at a specific zero-based index.

  • Utilisez la GetEnumerator méthode pour créer un énumérateur qui peut être utilisé pour itérer au sein de la collection.Use the GetEnumerator method to create an enumerator that can be used to iterate through the collection.

  • Utilisez foreach (C#) ou For Each (Visual Basic) pour itérer au sein de la collection.Use foreach (C#) or For Each (Visual Basic) to iterate through the collection.

  • Utilisez la CopyTo méthode pour copier le contenu de la collection dans un Array objet.Use the CopyTo method to copy the contents of the collection into an Array object.

Vous pouvez gérer par programmation le TreeNodeCollection en ajoutant et en supprimant TreeNode des objets.You can programmatically manage the TreeNodeCollection by adding and removing TreeNode objects. Pour ajouter des nœuds à la collection, Add utilisez AddAt la méthode ou.To add nodes to the collection, use the Add or AddAt method. Pour supprimer des nœuds de la collection, Removeutilisez RemoveAtla méthode Clear , ou.To remove nodes from the collection, use the Remove, RemoveAt, or Clear method.

Notes

Lorsque le TreeView contrôle est lié à une source de données, Nodes les ChildNodes collections et sont automatiquement renseignées chaque fois que la liaison est effectuée.When the TreeView control is bound to a data source, the Nodes and ChildNodes collections are automatically populated each time binding occurs. Toute modification apportée aux collections entre les liaisons sera perdue.Any changes to the collections between bindings will be lost. Pour conserver ces modifications, mettez à jour la source de données ou régénérez manuellement la collection chaque fois que vous effectuez une liaison.To retain these changes, either update the data source or manually rebuild the collection each time you bind.

TreeNodeCollection Contient des propriétés et des méthodes qui vous permettent de récupérer des informations sur la collection elle-même.The TreeNodeCollection contains properties and methods that allow you to retrieve information about the collection itself. Pour connaître le nombre d’éléments présents dans la collection, utilisez la Count propriété.To find out how many items are in the collection, use the Count property. Si vous souhaitez déterminer si la collection contient un certain TreeNode objet, utilisez la Contains méthode.If you want to determine whether the collection contains a certain TreeNode object, use the Contains method. Pour obtenir l’index d’un TreeNode objet dans la collection, utilisez la IndexOf méthode.To get the index of a TreeNode object in the collection, use the IndexOf method.

Constructeurs

TreeNodeCollection()

Initialise une nouvelle instance de la classe TreeNodeCollection à l'aide des valeurs par défaut.Initializes a new instance of the TreeNodeCollection class using the default values.

TreeNodeCollection(TreeNode)

Initialise une nouvelle instance de la classe TreeNodeCollection à l'aide du nœud parent (ou propriétaire) spécifié.Initializes a new instance of the TreeNodeCollection class using the specified parent node (or owner).

Propriétés

Count

Obtient le nombre d'éléments dans l'objet TreeNodeCollection.Gets the number of items in the TreeNodeCollection object.

IsSynchronized

Obtient une valeur indiquant si l'accès à TreeNodeCollection est synchronisé (thread-safe).Gets a value indicating whether access to the TreeNodeCollection is synchronized (thread safe).

Item[Int32]

Obtient l'objet TreeNode à l'index spécifié dans l'objet TreeNodeCollection.Gets the TreeNode object at the specified index in the TreeNodeCollection object.

SyncRoot

Obtient un objet qui peut être utilisé pour synchroniser l’accès à l’objet TreeNodeCollection.Gets an object that can be used to synchronize access to the TreeNodeCollection object.

Méthodes

Add(TreeNode)

Ajoute l'objet TreeNode spécifié à la fin de l'objet TreeNodeCollection.Appends the specified TreeNode object to the end of the TreeNodeCollection object.

AddAt(Int32, TreeNode)

Insère l'objet TreeNode spécifié dans un objet TreeNodeCollection à l'emplacement d'index spécifié.Inserts the specified TreeNode object in a TreeNodeCollection object at the specified index location.

Clear()

Vide l'objet TreeNodeCollection.Empties the TreeNodeCollection object.

Contains(TreeNode)

Détermine si l'objet TreeNode spécifié se trouve dans la collection.Determines whether the specified TreeNode object is in the 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.Copies all the items from the TreeNodeCollection object to a compatible one-dimensional array of TreeNode objects, starting at the specified index in the target array.

Equals(Object)

Détermine si l'objet spécifié est égal à l'objet actuel.Determines whether the specified object is equal to the current object.

(Hérité de Object)
GetEnumerator()

Retourne un énumérateur qui peut être utilisé pour itérer au sein d'un objet TreeNodeCollection.Returns an enumerator that can be used to iterate through a TreeNodeCollection object.

GetHashCode()

Sert de fonction de hachage par défaut.Serves as the default hash function.

(Hérité de Object)
GetType()

Obtient le Type de l'instance actuelle.Gets the Type of the current instance.

(Hérité de Object)
IndexOf(TreeNode)

Détermine l'index de l'objet TreeNode spécifié.Determines the index of the specified TreeNode object.

MemberwiseClone()

Crée une copie superficielle du Object actuel.Creates a shallow copy of the current Object.

(Hérité de Object)
Remove(TreeNode)

Supprime l'objet TreeNode spécifié de l'objet TreeNodeCollection.Removes the specified TreeNode object from the TreeNodeCollection object.

RemoveAt(Int32)

Supprime l'objet TreeNode à l'emplacement d'index spécifié de l'objet TreeNodeCollection.Removes the TreeNode object at the specified index location from the TreeNodeCollection object.

ToString()

Retourne une chaîne qui représente l'objet en cours.Returns a string that represents the current object.

(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.Copies all the items from the TreeNodeCollection object to a compatible one-dimensional Array, starting at the specified index in the target array.

IStateManager.IsTrackingViewState

Obtient une valeur indiquant si l'objet TreeNodeCollection enregistre les modifications apportées à son état d'affichage.Gets a value indicating whether the TreeNodeCollection object is saving changes to its view state.

IStateManager.LoadViewState(Object)

Charge l'état d'affichage précédemment enregistré de l'objet TreeNodeCollection.Loads the TreeNodeCollection object's previously saved view state.

IStateManager.SaveViewState()

Enregistre les modifications apportées à l'état d'affichage dans Object.Saves the changes to view state to a Object.

IStateManager.TrackViewState()

Prescrit à TreeNodeCollection d'assurer le suivi des modifications apportées à son état d'affichage.Instructs the TreeNodeCollection to track changes to its view state.

Méthodes d’extension

Cast<TResult>(IEnumerable)

Effectue un cast des éléments d'un IEnumerable vers le type spécifié.Casts the elements of an IEnumerable to the specified type.

OfType<TResult>(IEnumerable)

Filtre les éléments d'un IEnumerable en fonction du type spécifié.Filters the elements of an IEnumerable based on a specified type.

AsParallel(IEnumerable)

Active la parallélisation d'une requête.Enables parallelization of a query.

AsQueryable(IEnumerable)

Convertit un IEnumerable en IQueryable.Converts an IEnumerable to an IQueryable.

S’applique à

Voir aussi