TreeNodeCollection Classe

Definição

Representa uma coleção de objetos TreeNode no controle TreeView .Represents a collection of TreeNode objects in the TreeView control. Essa classe não pode ser herdada.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
Herança
TreeNodeCollection
Implementações

Exemplos

O exemplo a seguir demonstra como adicionar nós programaticamente a eles e removê TreeNodeCollection-los de um.The following example demonstrates how to programmatically add nodes to and remove them from a TreeNodeCollection. Observe que as Nodes propriedades ChildNodes e retornam TreeNodeCollection um objeto.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>

Comentários

A TreeNodeCollection classe é usada para armazenar e gerenciar uma coleção de TreeNode objetos no TreeView controle.The TreeNodeCollection class is used to store and manage a collection of TreeNode objects in the TreeView control. O TreeView controle usa a TreeNodeCollection classe em duas de suas propriedades.The TreeView control uses the TreeNodeCollection class in two of its properties. Ele armazena seus nós raiz na Nodes Propriedade e seus nós selecionados CheckedNodes na propriedade.It stores its root nodes in the Nodes property and its selected nodes in the CheckedNodes property. A TreeNodeCollection coleção também é usada para a ChildNodes propriedade armazenar nós filho (se houver).The TreeNodeCollection collection is also used for the ChildNodes property to store child nodes (if any).

A TreeNodeCollection classe oferece suporte a várias maneiras de acessar os itens na coleção:The TreeNodeCollection class supports several ways to access the items in the collection:

  • Use o Item[Int32] indexador para recuperar um TreeNode objeto diretamente em um índice de base zero específico.Use the Item[Int32] indexer to retrieve a TreeNode object directly at a specific zero-based index.

  • Use o GetEnumerator método para criar um enumerador que pode ser usado para iterar pela coleção.Use the GetEnumerator method to create an enumerator that can be used to iterate through the collection.

  • Use foreach (C#) ou For Each (Visual Basic) para iterar pela coleção.Use foreach (C#) or For Each (Visual Basic) to iterate through the collection.

  • Use o CopyTo método para copiar o conteúdo da coleção em um Array objeto.Use the CopyTo method to copy the contents of the collection into an Array object.

Você pode gerenciar o de TreeNodeCollection forma programática adicionando e TreeNode removendo objetos.You can programmatically manage the TreeNodeCollection by adding and removing TreeNode objects. Para adicionar nós à coleção, use o Add método ou. AddAtTo add nodes to the collection, use the Add or AddAt method. Para remover nós da coleção, use o Removemétodo, RemoveAtou. ClearTo remove nodes from the collection, use the Remove, RemoveAt, or Clear method.

Observação

Quando o TreeView controle está associado a uma fonte de dados, Nodes as ChildNodes coleções e são preenchidas automaticamente toda vez que ocorre a associação.When the TreeView control is bound to a data source, the Nodes and ChildNodes collections are automatically populated each time binding occurs. As alterações nas coleções entre as associações serão perdidas.Any changes to the collections between bindings will be lost. Para manter essas alterações, atualize a fonte de dados ou recompile manualmente a coleção cada vez que você associar.To retain these changes, either update the data source or manually rebuild the collection each time you bind.

O TreeNodeCollection contém propriedades e métodos que permitem que você recupere informações sobre a coleção em si.The TreeNodeCollection contains properties and methods that allow you to retrieve information about the collection itself. Para descobrir quantos itens estão na coleção, use a Count propriedade.To find out how many items are in the collection, use the Count property. Se você quiser determinar se a coleção contém um determinado TreeNode objeto, use o Contains método.If you want to determine whether the collection contains a certain TreeNode object, use the Contains method. Para obter o índice de um TreeNode objeto na coleção, use o IndexOf método.To get the index of a TreeNode object in the collection, use the IndexOf method.

Construtores

TreeNodeCollection()

Inicializa uma nova instância da classe TreeNodeCollection usando os valores padrão.Initializes a new instance of the TreeNodeCollection class using the default values.

TreeNodeCollection(TreeNode)

Inicializa uma nova instância da classe TreeNodeCollection usando o nó pai (ou proprietário) especificado.Initializes a new instance of the TreeNodeCollection class using the specified parent node (or owner).

Propriedades

Count

Obtém o número de itens no objeto TreeNodeCollection.Gets the number of items in the TreeNodeCollection object.

IsSynchronized

Obtém um valor que indica se o acesso à TreeNodeCollection é sincronizado (thread-safe).Gets a value indicating whether access to the TreeNodeCollection is synchronized (thread safe).

Item[Int32]

Obtém o objeto TreeNode no índice especificado no objeto TreeNodeCollection.Gets the TreeNode object at the specified index in the TreeNodeCollection object.

SyncRoot

Obtém um objeto que pode ser usado para sincronizar o acesso ao objeto TreeNodeCollection.Gets an object that can be used to synchronize access to the TreeNodeCollection object.

Métodos

Add(TreeNode)

Acrescenta o objeto TreeNode especificado ao final do objeto TreeNodeCollection.Appends the specified TreeNode object to the end of the TreeNodeCollection object.

AddAt(Int32, TreeNode)

Insere o objeto TreeNode especificado no objeto TreeNodeCollection no local de índice especificado.Inserts the specified TreeNode object in a TreeNodeCollection object at the specified index location.

Clear()

Esvazia o objeto TreeNodeCollection.Empties the TreeNodeCollection object.

Contains(TreeNode)

Determina se o objeto TreeNode especificado está na coleção.Determines whether the specified TreeNode object is in the collection.

CopyTo(TreeNode[], Int32)

Copia todos os itens do objeto TreeNodeCollection para uma matriz unidimensional compatível de objetos TreeNode, começando no índice especificado na matriz de destino.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)

Determina se o objeto especificado é igual ao objeto atual.Determines whether the specified object is equal to the current object.

(Herdado de Object)
GetEnumerator()

Retorna um enumerador que pode ser usado para iterar por um objeto TreeNodeCollection.Returns an enumerator that can be used to iterate through a TreeNodeCollection object.

GetHashCode()

Serve como a função de hash padrão.Serves as the default hash function.

(Herdado de Object)
GetType()

Obtém o Type da instância atual.Gets the Type of the current instance.

(Herdado de Object)
IndexOf(TreeNode)

Determina o índice do objeto TreeNode especificado.Determines the index of the specified TreeNode object.

MemberwiseClone()

Cria uma cópia superficial do Object atual.Creates a shallow copy of the current Object.

(Herdado de Object)
Remove(TreeNode)

Remove o objeto TreeNode especificado do objeto TreeNodeCollection.Removes the specified TreeNode object from the TreeNodeCollection object.

RemoveAt(Int32)

Remove o objeto TreeNode no local do índice especificado do objeto TreeNodeCollection.Removes the TreeNode object at the specified index location from the TreeNodeCollection object.

ToString()

Retorna uma cadeia de caracteres que representa o objeto atual.Returns a string that represents the current object.

(Herdado de Object)

Implantações explícitas de interface

ICollection.CopyTo(Array, Int32)

Copia todos os itens do objeto TreeNodeCollection para uma matriz unidimensional Arraycompatível, começando no índice especificado na matriz de destino.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

Obtém um valor que indica se o objeto TreeNodeCollection está salvando alterações no estado de exibição.Gets a value indicating whether the TreeNodeCollection object is saving changes to its view state.

IStateManager.LoadViewState(Object)

Carrega o estado de exibição salvo anteriormente do objeto TreeNodeCollection.Loads the TreeNodeCollection object's previously saved view state.

IStateManager.SaveViewState()

Salva as alterações no estado de exibição para um Object.Saves the changes to view state to a Object.

IStateManager.TrackViewState()

Instrui a TreeNodeCollection rastrear alterações do seu estado de exibição.Instructs the TreeNodeCollection to track changes to its view state.

Métodos de Extensão

Cast<TResult>(IEnumerable)

Converte os elementos de um IEnumerable para o tipo especificado.Casts the elements of an IEnumerable to the specified type.

OfType<TResult>(IEnumerable)

Filtra os elementos de um IEnumerable com base em um tipo especificado.Filters the elements of an IEnumerable based on a specified type.

AsParallel(IEnumerable)

Habilita a paralelização de uma consulta.Enables parallelization of a query.

AsQueryable(IEnumerable)

Converte um IEnumerable em um IQueryable.Converts an IEnumerable to an IQueryable.

Aplica-se a

Veja também