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>

Комментарии

Класс используется для хранения TreeNode коллекции объектов в TreeView элементе управления и управления ею. TreeNodeCollectionThe 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. Коллекция также используется в ChildNodes качестве свойства для хранения дочерних узлов (если они есть). TreeNodeCollectionThe 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:

  • Используйте индексатор, чтобы получить объект непосредственно в определенном индексе, начинающемся с нуля. TreeNode Item[Int32]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 прохода по For Each коллекции используйте (C#) или (Visual Basic).Use foreach (C#) or For Each (Visual Basic) to iterate through the collection.

  • Используйте метод, чтобы скопировать содержимое коллекции Array в объект. CopyToUse 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 метод или. AddAtTo 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.

Примечание

Если элемент управления привязан к источнику данных Nodes , коллекции и ChildNodes автоматически заполняются при каждой привязке. TreeViewWhen 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.

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

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