TreeNodeCollection Classe

Definição

Espaço de Nomes:: System.Web.UI.WebControls

Assemblagem:: System.Web.dll

Importante

Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.

Representa uma coleção de TreeNode objetos no TreeView controlo. Esta 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 seguinte demonstra como adicionar e remover programáticamente nós a um TreeNodeCollection. Note que as Nodes propriedades e 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>

Observações

A TreeNodeCollection classe é usada para armazenar e gerir uma coleção de TreeNode objetos no TreeView controlo. O TreeView controlo utiliza a TreeNodeCollection classe em duas das suas propriedades. Armazena os seus nós raiz na Nodes propriedade e os nós selecionados na CheckedNodes propriedade. A TreeNodeCollection coleção também é usada para armazenar ChildNodes nós filhos (se existirem).

A TreeNodeCollection classe suporta várias formas de aceder aos itens da coleção:

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

Podes gerir programaticamente o TreeNodeCollection adicionando e removendo TreeNode objetos. Para adicionar nós à coleção, use o Add método ou AddAt . Para remover nós da coleção, use o Remove, RemoveAt, ou Clear o método.

Note

Quando o controlo TreeView está ligado a uma fonte de dados, as Nodes coleções e ChildNodes são automaticamente preenchidas sempre que ocorre a ligação. Quaisquer alterações às coleções entre encadernações serão perdidas. Para manter estas alterações, atualize a fonte de dados ou reconstrua manualmente a coleção cada vez que a vincular.

Contém TreeNodeCollection propriedades e métodos que permitem obter informação sobre a própria coleção. Para saber quantos itens há na coleção, utilize a Count propriedade. Se 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

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

Propriedades

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

Métodos

Name	Description
Add(TreeNode)	Acrescenta o objeto especificado TreeNode ao final do TreeNodeCollection objeto.
AddAt(Int32, TreeNode)	Insere o objeto especificado TreeNode num TreeNodeCollection objeto na localização do índice especificada.
Clear()	Esvazia o TreeNodeCollection objeto.
Contains(TreeNode)	Determina se o objeto especificado TreeNode está na coleção.
CopyTo(TreeNode[], Int32)	Copia todos os itens do TreeNodeCollection objeto para um array unidimensional compatível de TreeNode objectos, começando no índice especificado no array-alvo.
Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
GetEnumerator()	Devolve um enumerador que pode ser usado para iterar através de um TreeNodeCollection objeto.
GetHashCode()	Serve como função de hash predefinida. (Herdado de Object)
GetType()	Obtém o Type da instância atual. (Herdado de Object)
IndexOf(TreeNode)	Determina o índice do objeto especificado TreeNode .
MemberwiseClone()	Cria uma cópia superficial do atual Object. (Herdado de Object)
Remove(TreeNode)	Remove o objeto especificado TreeNode do TreeNodeCollection objeto.
RemoveAt(Int32)	Remove o TreeNode objeto na localização de índice especificada do TreeNodeCollection objeto.
ToString()	Devolve uma cadeia que representa o objeto atual. (Herdado de Object)

Implementações de Interface Explícita

Name	Description
ICollection.CopyTo(Array, Int32)	Copia todos os itens do TreeNodeCollection objeto para um unidimensional Arraycompatível , começando no índice especificado no array alvo.
IStateManager.IsTrackingViewState	Recebe um valor que indica se o TreeNodeCollection objeto está a guardar alterações ao seu estado de visualização.
IStateManager.LoadViewState(Object)	Carrega o TreeNodeCollection estado de visualização previamente guardado do objeto.
IStateManager.SaveViewState()	Guarda as alterações para o estado de visualização para um Object.
IStateManager.TrackViewState()	Instrui o TreeNodeCollection a acompanhar alterações ao seu estado de visualização.

Métodos da Extensão

Name	Description
AsParallel(IEnumerable)	Permite a paralelização de uma consulta.
AsQueryable(IEnumerable)	Converte um IEnumerable para um IQueryable.
Cast<TResult>(IEnumerable)	Conjura os elementos de an IEnumerable para o tipo especificado.
OfType<TResult>(IEnumerable)	Filtra os elementos de um IEnumerable com base num tipo especificado.

Aplica-se a

Ver também

Comentários

Esta página foi útil?