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 folgende Beispiel wird veranschaulicht, wie Sie programmgesteuert hinzufügen und Entfernen von einem TreeNodeCollection.The following example demonstrates how to programmatically add nodes to and remove them from a TreeNodeCollection. Beachten Sie, dass die Nodes und ChildNodes Eigenschaften zurückgeben einer TreeNodeCollection Objekt.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 dient zum Speichern und verwalten eine Auflistung von TreeNode Objekte in der TreeView Steuerelement.The TreeNodeCollection class is used to store and manage a collection of TreeNode objects in the TreeView control. Die TreeView -Steuerelement verwendet die TreeNodeCollection Klasse in zwei seiner Eigenschaften.The TreeView control uses the TreeNodeCollection class in two of its properties. Es speichert die Stammknoten in der Nodes -Eigenschaft und die ausgewählten Knoten in der CheckedNodes Eigenschaft.It stores its root nodes in the Nodes property and its selected nodes in the CheckedNodes property. Die TreeNodeCollection Auflistung wird auch verwendet, für die ChildNodes Eigenschaft zum Speichern von untergeordneten Knoten (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, die Elemente in der Auflistung zuzugreifen:The TreeNodeCollection class supports several ways to access the items in the collection:

  • Verwenden der Item[Int32] Indexer zum Abrufen einer TreeNode Objekt direkt am angegebenen nullbasierten Index.Use the Item[Int32] indexer to retrieve a TreeNode object directly at a specific zero-based index.

  • Verwenden der GetEnumerator Methode zum Erstellen eines Enumerators, 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.

  • Verwendung foreach (C#) oder For Each (Visual Basic) zum Durchlaufen der Auflistung.Use foreach (C#) or For Each (Visual Basic) to iterate through the collection.

  • Verwenden der CopyTo Methode zum Kopieren der Inhalte der Auflistung in ein Array Objekt.Use the CopyTo method to copy the contents of the collection into an Array object.

Sie können programmgesteuert verwalten die TreeNodeCollection durch Hinzufügen und Entfernen von TreeNode Objekte.You can programmatically manage the TreeNodeCollection by adding and removing TreeNode objects. Verwenden Sie zum Hinzufügen von Knoten auf die Auflistung der Add oder AddAt Methode.To add nodes to the collection, use the Add or AddAt method. Verwenden Sie zum Entfernen von Knoten aus der Auflistung der Remove, RemoveAt, oder Clear Methode.To remove nodes from the collection, use the Remove, RemoveAt, or Clear method.

Hinweis

Wenn die TreeView -Steuerelement an eine Datenquelle gebunden ist die Nodes und ChildNodes Sammlungen werden automatisch bei jedem Auftreten einer Bindung 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 Sammlungen zwischen Bindungen gehen verloren.Any changes to the collections between bindings will be lost. Um diese Änderungen beizubehalten, können Sie entweder aktualisieren Sie die Datenquelle oder manuell neu erstellen Sie, die jedes Mal, wenn Sie eine Bindung-Auflistung.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 zum Abrufen von Informationen über die Auflistung selbst.The TreeNodeCollection contains properties and methods that allow you to retrieve information about the collection itself. Um herauszufinden, wie viele Elemente in der Auflistung befinden, verwenden Sie die Count Eigenschaft.To find out how many items are in the collection, use the Count property. Sollten Sie bestimmen, ob die Auflistung ein bestimmtes TreeNode -Objekts die Contains Methode.If you want to determine whether the collection contains a certain TreeNode object, use the Contains method. Den Index des abzurufenden eine TreeNode Objekt in der Auflistung, die Verwendung der 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.

Extension Methods

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 eine IEnumerable auf eine IQueryable.Converts an IEnumerable to an IQueryable.

Gilt für:

Siehe auch