TreeNodeCollection TreeNodeCollection TreeNodeCollection TreeNodeCollection Class

Определение

Представляет коллекцию объектов TreeNode в элементе управления TreeView.Represents a collection of TreeNode objects in the TreeView control. Этот класс не наследуется.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
Наследование
TreeNodeCollectionTreeNodeCollectionTreeNodeCollectionTreeNodeCollection
Реализации

Примеры

Следующий пример демонстрирует программным способом добавить узлы и их удалению из TreeNodeCollection.The following example demonstrates how to programmatically add nodes to and remove them from a TreeNodeCollection. Обратите внимание, что Nodes и ChildNodes возвращают свойства TreeNodeCollection объекта.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>

Комментарии

TreeNodeCollection Класс используется для хранения и управления коллекцией TreeNode объекты в TreeView элемента управления.The TreeNodeCollection class is used to store and manage a collection of TreeNode objects in the TreeView control. TreeView Управления использует TreeNodeCollection класс в двух из его свойств.The TreeView control uses the TreeNodeCollection class in two of its properties. Она сохраняет его корневые узлы в Nodes свойство и его выбранные узлы в CheckedNodes свойство.It stores its root nodes in the Nodes property and its selected nodes in the CheckedNodes property. TreeNodeCollection Коллекции также используется для ChildNodes свойство для хранения дочерних узлов (при наличии).The TreeNodeCollection collection is also used for the ChildNodes property to store child nodes (if any).

TreeNodeCollection Класс поддерживает несколько способов доступа к элементам в коллекции:The TreeNodeCollection class supports several ways to access the items in the collection:

  • Используйте Item[Int32] индексатор для получения TreeNode объекта непосредственно с указанным индексом (с нуля).Use the Item[Int32] indexer to retrieve a TreeNode object directly at a specific zero-based index.

  • Используйте GetEnumerator метод для создания перечислителя, который может использоваться для итерации по коллекции.Use the GetEnumerator method to create an enumerator that can be used to iterate through the collection.

  • Используйте foreach (C#) или For Each (Visual Basic) для выполнения итерации по коллекции.Use foreach (C#) or For Each (Visual Basic) to iterate through the collection.

  • Используйте CopyTo метод, чтобы скопировать содержимое коллекции в Array объекта.Use the CopyTo method to copy the contents of the collection into an Array object.

Можно программно управлять TreeNodeCollection , добавляя и удаляя TreeNode объектов.You can programmatically manage the TreeNodeCollection by adding and removing TreeNode objects. Чтобы добавить узлы в коллекцию, используйте Add или AddAt метод.To add nodes to the collection, use the Add or AddAt method. Чтобы удалить узлы из коллекции, используйте Remove, RemoveAt, или Clear метод.To remove nodes from the collection, use the Remove, RemoveAt, or Clear method.

Примечание

Когда TreeView управления привязан к источнику данных, Nodes и ChildNodes коллекций заполняются автоматически каждый раз при привязке.When the TreeView control is bound to a data source, the Nodes and ChildNodes collections are automatically populated each time binding occurs. Любые изменения в коллекциях между привязками будут потеряны.Any changes to the collections between bindings will be lost. Чтобы сохранить эти изменения, обновить источник данных или вручную перестроить коллекции каждый раз, когда можно выполнить привязку.To retain these changes, either update the data source or manually rebuild the collection each time you bind.

TreeNodeCollection Содержит свойства и методы, которые позволяют получить сведения о самой коллекции.The TreeNodeCollection contains properties and methods that allow you to retrieve information about the collection itself. Чтобы узнать, сколько элементов находятся в коллекции, используйте Count свойство.To find out how many items are in the collection, use the Count property. Если вы хотите определить, содержит ли коллекция определенный TreeNode , используйте Contains метод.If you want to determine whether the collection contains a certain TreeNode object, use the Contains method. Чтобы получить индекс TreeNode объекта в коллекции, используйте IndexOf метод.To get the index of a TreeNode object in the collection, use the IndexOf method.

Конструкторы

TreeNodeCollection() TreeNodeCollection() TreeNodeCollection() TreeNodeCollection()

Инициализирует новый экземпляр класса TreeNodeCollection, используя значения по умолчанию.Initializes a new instance of the TreeNodeCollection class using the default values.

TreeNodeCollection(TreeNode) TreeNodeCollection(TreeNode) TreeNodeCollection(TreeNode) TreeNodeCollection(TreeNode)

Инициализирует новый экземпляр класса TreeNodeCollection, используя указанный родительский узел (или владелец).Initializes a new instance of the TreeNodeCollection class using the specified parent node (or owner).

Свойства

Count Count Count Count

Возвращает количество элементов в объекте TreeNodeCollection.Gets the number of items in the TreeNodeCollection object.

IsSynchronized IsSynchronized IsSynchronized IsSynchronized

Возвращает значение, показывающее, является ли доступ к коллекции TreeNodeCollection синхронизированным (потокобезопасным).Gets a value indicating whether access to the TreeNodeCollection is synchronized (thread safe).

Item[Int32] Item[Int32] Item[Int32] Item[Int32]

Возвращает TreeNode, расположенный в объекте TreeNodeCollection по указанному индексу.Gets the TreeNode object at the specified index in the TreeNodeCollection object.

SyncRoot SyncRoot SyncRoot SyncRoot

Возвращает объект, который позволяет синхронизировать доступ к объекту TreeNodeCollection.Gets an object that can be used to synchronize access to the TreeNodeCollection object.

Методы

Add(TreeNode) Add(TreeNode) Add(TreeNode) Add(TreeNode)

Добавляет указанный объект TreeNode в конец объекта TreeNodeCollection.Appends the specified TreeNode object to the end of the TreeNodeCollection object.

AddAt(Int32, TreeNode) AddAt(Int32, TreeNode) AddAt(Int32, TreeNode) AddAt(Int32, TreeNode)

Вставляет указанный объект TreeNode в объект TreeNodeCollection по указанному индексу.Inserts the specified TreeNode object in a TreeNodeCollection object at the specified index location.

Clear() Clear() Clear() Clear()

Опустошает объект TreeNodeCollection.Empties the TreeNodeCollection object.

Contains(TreeNode) Contains(TreeNode) Contains(TreeNode) Contains(TreeNode)

Определяет, присутствует ли в коллекции указанный объект TreeNode.Determines whether the specified TreeNode object is in the collection.

CopyTo(TreeNode[], Int32) CopyTo(TreeNode[], Int32) CopyTo(TreeNode[], Int32) CopyTo(TreeNode[], Int32)

Копирует все элементы из объекта TreeNodeCollection в совместимый одномерный массив объектов TreeNode, начиная с указанного индекса в массиве назначения.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) Equals(Object) Equals(Object) Equals(Object)

Определяет, равен ли заданный объект текущему объекту.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetEnumerator() GetEnumerator() GetEnumerator() GetEnumerator()

Возвращает перечислитель, который может использоваться для итерации по объекту TreeNodeCollection.Returns an enumerator that can be used to iterate through a TreeNodeCollection object.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Служит хэш-функцией по умолчанию.Serves as the default hash function.

(Inherited from Object)
GetType() GetType() GetType() GetType()

Возвращает объект Type для текущего экземпляра.Gets the Type of the current instance.

(Inherited from Object)
IndexOf(TreeNode) IndexOf(TreeNode) IndexOf(TreeNode) IndexOf(TreeNode)

Определяет индекс указанного объекта TreeNode.Determines the index of the specified TreeNode object.

MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Создает неполную копию текущего объекта Object.Creates a shallow copy of the current Object.

(Inherited from Object)
Remove(TreeNode) Remove(TreeNode) Remove(TreeNode) Remove(TreeNode)

Удаляет указанный объект TreeNode из объекта TreeNodeCollection.Removes the specified TreeNode object from the TreeNodeCollection object.

RemoveAt(Int32) RemoveAt(Int32) RemoveAt(Int32) RemoveAt(Int32)

Удаляет объект TreeNode по указанному индексу из объекта TreeNodeCollection.Removes the TreeNode object at the specified index location from the TreeNodeCollection object.

ToString() ToString() ToString() ToString()

Возвращает строку, представляющую текущий объект.Returns a string that represents the current object.

(Inherited from Object)

Явные реализации интерфейса

ICollection.CopyTo(Array, Int32) ICollection.CopyTo(Array, Int32) ICollection.CopyTo(Array, Int32) ICollection.CopyTo(Array, Int32)

Копирует все элементы из объекта TreeNodeCollection в совместимый одномерный массив Array, начиная с указанного индекса в массиве назначения.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 IStateManager.IsTrackingViewState IStateManager.IsTrackingViewState IStateManager.IsTrackingViewState

Получает значение, указывающее сохраняет ли объект TreeNodeCollection изменения в данных о состоянии представления.Gets a value indicating whether the TreeNodeCollection object is saving changes to its view state.

IStateManager.LoadViewState(Object) IStateManager.LoadViewState(Object) IStateManager.LoadViewState(Object) IStateManager.LoadViewState(Object)

Загружает сохраненное ранее состояние представления объекта TreeNodeCollection.Loads the TreeNodeCollection object's previously saved view state.

IStateManager.SaveViewState() IStateManager.SaveViewState() IStateManager.SaveViewState() IStateManager.SaveViewState()

Сохраняет изменения состояния представления в Object.Saves the changes to view state to a Object.

IStateManager.TrackViewState() IStateManager.TrackViewState() IStateManager.TrackViewState() IStateManager.TrackViewState()

Указывает TreeNodeCollection на необходимость отслеживания изменений в его состоянии представления.Instructs the TreeNodeCollection to track changes to its view state.

Методы расширения

Cast<TResult>(IEnumerable) Cast<TResult>(IEnumerable) Cast<TResult>(IEnumerable) Cast<TResult>(IEnumerable)

Приводит элементы объекта IEnumerable к заданному типу.Casts the elements of an IEnumerable to the specified type.

OfType<TResult>(IEnumerable) OfType<TResult>(IEnumerable) OfType<TResult>(IEnumerable) OfType<TResult>(IEnumerable)

Выполняет фильтрацию элементов объекта IEnumerable по заданному типу.Filters the elements of an IEnumerable based on a specified type.

AsParallel(IEnumerable) AsParallel(IEnumerable) AsParallel(IEnumerable) AsParallel(IEnumerable)

Позволяет осуществлять параллельный запрос.Enables parallelization of a query.

AsQueryable(IEnumerable) AsQueryable(IEnumerable) AsQueryable(IEnumerable) AsQueryable(IEnumerable)

Преобразует IEnumerable для IQueryable.Converts an IEnumerable to an IQueryable.

Применяется к

Дополнительно