TreeNodeCollection TreeNodeCollection TreeNodeCollection TreeNodeCollection Class

Definition

Stellt eine Auflistung von TreeNode -Objekten im TreeView -Steuerelement dar.Represents a collection of TreeNode objects in the TreeView control. Diese Klasse kann nicht vererbt werden.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
Vererbung
TreeNodeCollectionTreeNodeCollectionTreeNodeCollectionTreeNodeCollection
Implementiert

Beispiele

Im folgenden Beispiel wird veranschaulicht, wie Sie Knotenprogramm gesteuert hinzufügen und aus einer TreeNodeCollectionentfernen.The following example demonstrates how to programmatically add nodes to and remove them from a TreeNodeCollection. Beachten Sie, Nodes dass ChildNodes die Eigenschaften und TreeNodeCollection ein-Objekt zurückgeben.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>

Hinweise

Die TreeNodeCollection -Klasse wird verwendet, um eine Auflistung von TreeNode -Objekten im TreeView -Steuerelement zu speichern und zu verwalten.The TreeNodeCollection class is used to store and manage a collection of TreeNode objects in the TreeView control. Das TreeView -Steuerelement TreeNodeCollection verwendet die-Klasse in zwei seiner Eigenschaften.The TreeView control uses the TreeNodeCollection class in two of its properties. Die Stamm Knoten werden in der Nodes -Eigenschaft und den ausgewählten Knoten in der CheckedNodes -Eigenschaft gespeichert.It stores its root nodes in the Nodes property and its selected nodes in the CheckedNodes property. Die TreeNodeCollection -Auflistung wird auch für die ChildNodes -Eigenschaft verwendet, um untergeordnete Knoten zu speichern (sofern vorhanden).The TreeNodeCollection collection is also used for the ChildNodes property to store child nodes (if any).

Die TreeNodeCollection -Klasse unterstützt mehrere Möglichkeiten für den Zugriff auf die Elemente in der Auflistung:The TreeNodeCollection class supports several ways to access the items in the collection:

  • Verwenden Sie Item[Int32] den Indexer, um TreeNode ein-Objekt direkt an einem bestimmten Null basierten Index abzurufen.Use the Item[Int32] indexer to retrieve a TreeNode object directly at a specific zero-based index.

  • Verwenden Sie GetEnumerator die-Methode, um einen Enumerator zu erstellen, der zum Durchlaufen der Auflistung verwendet werden kann.Use the GetEnumerator method to create an enumerator that can be used to iterate through the collection.

  • Verwenden foreach SieC#() For Each oder (Visual Basic), um die Auflistung zu durchlaufen.Use foreach (C#) or For Each (Visual Basic) to iterate through the collection.

  • Verwenden Sie CopyTo die-Methode, um den Inhalt der Auflistung in Array ein-Objekt zu kopieren.Use the CopyTo method to copy the contents of the collection into an Array object.

Sie können den TreeNodeCollection Programm gesteuert verwalten, indem Sie- TreeNode Objekte hinzufügen und entfernen.You can programmatically manage the TreeNodeCollection by adding and removing TreeNode objects. Um der Auflistung Knoten hinzuzufügen, verwenden Sie Add die AddAt -Methode oder die-Methode.To add nodes to the collection, use the Add or AddAt method. Verwenden Sie die RemoveMethode, RemoveAtoder Clear , um Knoten aus der Auflistung zu entfernen.To remove nodes from the collection, use the Remove, RemoveAt, or Clear method.

Hinweis

Wenn das TreeView -Steuerelement an eine Datenquelle gebunden ist Nodes , ChildNodes werden die-Auflistung und die-Auflistung bei jedem Auftreten der Bindung automatisch aufgefüllt.When the TreeView control is bound to a data source, the Nodes and ChildNodes collections are automatically populated each time binding occurs. Alle Änderungen an den Sammlungen zwischen Bindungen gehen verloren.Any changes to the collections between bindings will be lost. Um diese Änderungen beizubehalten, aktualisieren Sie entweder die Datenquelle, oder erstellen Sie die Sammlung bei jedem binden manuell neu.To retain these changes, either update the data source or manually rebuild the collection each time you bind.

Die TreeNodeCollection enthält Eigenschaften und Methoden, mit denen Sie Informationen über die Auflistung selbst abrufen können.The TreeNodeCollection contains properties and methods that allow you to retrieve information about the collection itself. Verwenden Sie die Count -Eigenschaft, um herauszufinden, wie viele Elemente in der Auflistung sind.To find out how many items are in the collection, use the Count property. Wenn Sie bestimmen möchten, ob die Auflistung ein bestimmtes TreeNode Objekt enthält, verwenden Sie die Contains -Methode.If you want to determine whether the collection contains a certain TreeNode object, use the Contains method. Um den Index eines TreeNode -Objekts in der Auflistung zu erhalten, verwenden Sie die IndexOf -Methode.To get the index of a TreeNode object in the collection, use the IndexOf method.

Konstruktoren

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

Initialisiert eine neue Instanz der TreeNodeCollection-Klasse mit Standardwerten.Initializes a new instance of the TreeNodeCollection class using the default values.

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

Initialisiert eine neue Instanz der TreeNodeCollection-Klasse unter Verwendung des angegebenen übergeordneten Knotens (oder Besitzers).Initializes a new instance of the TreeNodeCollection class using the specified parent node (or owner).

Eigenschaften

Count Count Count Count

Ruft die Anzahl der Elemente im TreeNodeCollection-Objekt ab.Gets the number of items in the TreeNodeCollection object.

IsSynchronized IsSynchronized IsSynchronized IsSynchronized

Ruft einen Wert ab, der angibt, ob der Zugriff auf die TreeNodeCollection synchronisiert (threadsicher) ist.Gets a value indicating whether access to the TreeNodeCollection is synchronized (thread safe).

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

Ruft das TreeNode-Objekt am angegebenen Index im TreeNodeCollection-Objekt ab.Gets the TreeNode object at the specified index in the TreeNodeCollection object.

SyncRoot SyncRoot SyncRoot SyncRoot

Ruft ein Objekt ab, mit dem der Zugriff auf das TreeNodeCollection-Objekt synchronisiert werden kann.Gets an object that can be used to synchronize access to the TreeNodeCollection object.

Methoden

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

Fügt das angegebene TreeNode-Objekt an das Ende des TreeNodeCollection-Objekts an.Appends the specified TreeNode object to the end of the TreeNodeCollection object.

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

Fügt das angegebene TreeNode-Objekt an der angegebenen Indexposition in einem TreeNodeCollection-Objekt ein.Inserts the specified TreeNode object in a TreeNodeCollection object at the specified index location.

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

Leert das TreeNodeCollection-Objekt.Empties the TreeNodeCollection object.

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

Bestimmt, ob das angegebene TreeNode-Objekt in der Auflistung vorhanden ist.Determines whether the specified TreeNode object is in the collection.

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

Kopiert alle Elemente aus dem TreeNodeCollection-Objekt in ein kompatibles eindimensionales Array von TreeNode-Objekten, wobei am angegebenen Index des Zielarrays begonnen wird.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)

Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist.Determines whether the specified object is equal to the current object.

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

Gibt einen Enumerator zurück, mit dem ein TreeNodeCollection-Objekt durchlaufen werden kann.Returns an enumerator that can be used to iterate through a TreeNodeCollection object.

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

Fungiert als Standardhashfunktion.Serves as the default hash function.

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

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

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

Ruft den Index des angegebenen TreeNode-Objekts ab.Determines the index of the specified TreeNode object.

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

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

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

Entfernt das angegebene TreeNode-Objekt aus dem TreeNodeCollection-Objekt.Removes the specified TreeNode object from the TreeNodeCollection object.

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

Entfernt das TreeNode-Objekt an der angegebenen Indexposition aus dem TreeNodeCollection-Objekt.Removes the TreeNode object at the specified index location from the TreeNodeCollection object.

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

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.Returns a string that represents the current object.

(Inherited from Object)

Explizite Schnittstellenimplementierungen

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

Kopiert alle Elemente aus dem TreeNodeCollection-Objekt in ein kompatibles eindimensionales Array, wobei bei dem angegebenen Index des Zielarrays begonnen wird.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

Ruft einen Wert ab, der angibt, ob das TreeNodeCollection-Objekt Änderungen des Ansichtszustands speichert.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)

Lädt den zuvor gespeicherten Ansichtszustand des TreeNodeCollection-Objekts.Loads the TreeNodeCollection object's previously saved view state.

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

Speichert die Änderungen am Ansichtszustand in einem Object.Saves the changes to view state to a Object.

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

Weist die TreeNodeCollection an, Änderungen am Ansichtszustand nachzuverfolgen.Instructs the TreeNodeCollection to track changes to its view state.

Erweiterungsmethoden

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

Wandelt die Elemente eines IEnumerable in den angegebenen Typ umCasts the elements of an IEnumerable to the specified type.

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

Filtert die Elemente eines IEnumerable anhand eines angegebenen TypsFilters the elements of an IEnumerable based on a specified type.

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

Ermöglicht die Parallelisierung einer Abfrage.Enables parallelization of a query.

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

Konvertiert einen IEnumerable in einen IQueryable.Converts an IEnumerable to an IQueryable.

Gilt für:

Siehe auch