TreeNodeCollection Classe

Referência

Definição

Namespace:: System.Web.UI.WebControls

Assembly:: System.Web.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Representa uma coleção de objetos TreeNode no controle TreeView . Essa classe não pode ser herdada.

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: Object
TreeNodeCollection

Implementações: ICollection IEnumerable IStateManager

Exemplos

O exemplo a seguir demonstra como adicionar nós programaticamente e removê-los de um TreeNodeCollection. Observe que as propriedades e as Nodes propriedades ChildNodes retornam um TreeNodeCollection objeto.


<%@ 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. O TreeView controle usa a TreeNodeCollection classe em duas de suas propriedades. Ele armazena seus nós raiz na Nodes propriedade e seus nós selecionados na CheckedNodes propriedade. A TreeNodeCollection coleção também é usada para a ChildNodes propriedade armazenar nós filho (se houver).

A TreeNodeCollection classe dá suporte a várias maneiras de acessar os itens na coleção:

Use o Item[] indexador para recuperar um TreeNode objeto diretamente em um índice baseado em zero específico.
Use o GetEnumerator método para criar um enumerador que pode ser usado para iterar por meio da coleção.
Use foreach (C#) ou For Each (Visual Basic) para iterar por meio da coleção.
Use o CopyTo método para copiar o conteúdo da coleção em um Array objeto.

Você pode gerenciar programaticamente a TreeNodeCollection adição e remoção de TreeNode objetos. Para adicionar nós à coleção, use o método ou AddAt o Add método. Para remover nós da coleção, use o Removemétodo ou Clear o métodoRemoveAt.

Observação

Quando o TreeView controle está associado a uma fonte de dados, as coleções e ChildNodes as Nodes coleções são preenchidas automaticamente sempre que a associação ocorre. Todas as alterações nas coleções entre as associações serão perdidas. Para manter essas alterações, atualize a fonte de dados ou recompile manualmente a coleção sempre que você associar.

Contém TreeNodeCollection propriedades e métodos que permitem que você recupere informações sobre a própria coleção. Para descobrir quantos itens estão na coleção, use a Count propriedade. Se você quiser determinar se a coleção contém um determinado TreeNode objeto, use o Contains método. Para obter o índice de um TreeNode objeto na coleção, use o IndexOf método.

Construtores

TreeNodeCollection()	Inicializa uma nova instância da classe TreeNodeCollection usando os valores padrão.
TreeNodeCollection(TreeNode)	Inicializa uma nova instância da classe TreeNodeCollection usando o nó pai (ou proprietário) especificado.

Propriedades

Count	Obtém o número de itens no objeto TreeNodeCollection.
IsSynchronized	Obtém um valor que indica se o acesso à TreeNodeCollection é sincronizado (thread-safe).
Item[Int32]	Obtém o objeto TreeNode no índice especificado no objeto TreeNodeCollection.
SyncRoot	Obtém um objeto que pode ser usado para sincronizar o acesso ao objeto TreeNodeCollection.

Métodos

Add(TreeNode)	Acrescenta o objeto TreeNode especificado ao final do objeto TreeNodeCollection.
AddAt(Int32, TreeNode)	Insere o objeto TreeNode especificado no objeto TreeNodeCollection no local de índice especificado.
Clear()	Esvazia o objeto TreeNodeCollection.
Contains(TreeNode)	Determina se o objeto TreeNode especificado está na coleção.
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.
Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
GetEnumerator()	Retorna um enumerador que pode ser usado para iterar por um objeto TreeNodeCollection.
GetHashCode()	Serve como a função de hash padrão. (Herdado de Object)
GetType()	Obtém o Type da instância atual. (Herdado de Object)
IndexOf(TreeNode)	Determina o índice do objeto TreeNode especificado.
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
Remove(TreeNode)	Remove o objeto TreeNode especificado do objeto TreeNodeCollection.
RemoveAt(Int32)	Remove o objeto TreeNode no local do índice especificado do objeto TreeNodeCollection.
ToString()	Retorna uma cadeia de caracteres que representa o objeto atual. (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.
IStateManager.IsTrackingViewState	Obtém um valor que indica se o objeto TreeNodeCollection está salvando alterações no estado de exibição.
IStateManager.LoadViewState(Object)	Carrega o estado de exibição salvo anteriormente do objeto TreeNodeCollection.
IStateManager.SaveViewState()	Salva as alterações no estado de exibição para um Object.
IStateManager.TrackViewState()	Instrui a TreeNodeCollection rastrear alterações do seu estado de exibição.

Métodos de Extensão

Cast<TResult>(IEnumerable)	Converte os elementos de um IEnumerable para o tipo especificado.
OfType<TResult>(IEnumerable)	Filtra os elementos de um IEnumerable com base em um tipo especificado.
AsParallel(IEnumerable)	Habilita a paralelização de uma consulta.
AsQueryable(IEnumerable)	Converte um IEnumerable em um IQueryable.

Aplica-se a