Homepage Library Lernen Downloads Support Community
Anmelden | United States - English | |
Dieser Artikel wurde manuell übersetzt. Bewegen Sie den Mauszeiger über die Sätze im Artikel, um den Originaltext anzuzeigen.
Übersetzung
Original
Dieser Artikel wurde noch nicht bewertet - Dieses Thema bewerten.

TreeNodeCollection-Klasse

.NET Framework 4

Stellt eine Auflistung von TreeNode-Objekten im TreeView-Steuerelement dar. Diese Klasse kann nicht vererbt werden.

System.Object
  System.Web.UI.WebControls.TreeNodeCollection

Namespace:  System.Web.UI.WebControls
Assembly:  System.Web (in System.Web.dll)
C#
C++
F#
VB
Kopieren 
public sealed class TreeNodeCollection : ICollection, 
	IEnumerable, IStateManager

Der TreeNodeCollection-Typ macht die folgenden Member verfügbar.

  Name Beschreibung
Öffentliche Methode TreeNodeCollection() Initialisiert eine neue Instanz der TreeNodeCollection-Klasse mit Standardwerten.
Öffentliche Methode TreeNodeCollection(TreeNode) Initialisiert eine neue Instanz der TreeNodeCollection-Klasse unter Verwendung des angegebenen übergeordneten Knotens (oder Besitzers).
Zum Seitenanfang
  Name Beschreibung
Öffentliche Eigenschaft Count Ruft die Anzahl der Elemente im TreeNodeCollection-Objekt ab.
Öffentliche Eigenschaft IsSynchronized Ruft einen Wert ab, der angibt, ob der Zugriff auf die TreeNodeCollection synchronisiert (threadsicher) ist.
Öffentliche Eigenschaft Item Ruft das TreeNode-Objekt am angegebenen Index im TreeNodeCollection-Objekt ab.
Öffentliche Eigenschaft SyncRoot Ruft ein Objekt ab, mit dem der Zugriff auf das TreeNodeCollection-Objekt synchronisiert werden kann.
Zum Seitenanfang
  Name Beschreibung
Öffentliche Methode Add Fügt das angegebene TreeNode-Objekt an das Ende des TreeNodeCollection-Objekts an.
Öffentliche Methode AddAt Fügt das angegebene TreeNode-Objekt an der angegebenen Indexposition in einem TreeNodeCollection-Objekt ein.
Öffentliche Methode Clear Leert das TreeNodeCollection-Objekt.
Öffentliche Methode Contains Bestimmt, ob das angegebene TreeNode-Objekt in dieser Auflistung vorhanden ist.
Öffentliche Methode CopyTo Kopiert alle Elemente aus dem TreeNodeCollection-Objekt in ein kompatibles eindimensionales Array von TreeNode-Objekten, wobei am angegebenen Index des Zielarrays begonnen wird.
Öffentliche Methode Equals(Object) Bestimmt, ob das angegebene Object und das aktuelle Object gleich sind. (Von Object geerbt.)
Geschützte Methode Finalize Gibt einem Objekt Gelegenheit zu dem Versuch, Ressourcen freizugeben und andere Bereinigungen durchzuführen, bevor es von der automatische Speicherbereinigung freigegeben wird. (Von Object geerbt.)
Öffentliche Methode GetEnumerator Gibt einen Enumerator zurück, mit dem ein TreeNodeCollection-Objekt durchlaufen werden kann.
Öffentliche Methode GetHashCode Fungiert als Hashfunktion für einen bestimmten Typ. (Von Object geerbt.)
Öffentliche Methode GetType Ruft den Type der aktuellen Instanz ab. (Von Object geerbt.)
Öffentliche Methode IndexOf Ruft den Index des angegebenen TreeNode-Objekts ab.
Geschützte Methode MemberwiseClone Erstellt eine flache Kopie des aktuellen Object. (Von Object geerbt.)
Öffentliche Methode Remove Entfernt das angegebene TreeNode-Objekt aus dem TreeNodeCollection-Objekt.
Öffentliche Methode RemoveAt Entfernt das TreeNode-Objekt an der angegebenen Indexposition aus dem TreeNodeCollection-Objekt.
Öffentliche Methode ToString Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Von Object geerbt.)
Zum Seitenanfang
  Name Beschreibung
Öffentliche Erweiterungsmethode AsParallel Ermöglicht die Parallelisierung einer Abfrage. (Durch ParallelEnumerable definiert.)
Öffentliche Erweiterungsmethode AsQueryable Konvertiert einen IEnumerable in einen IQueryable. (Durch Queryable definiert.)
Öffentliche Erweiterungsmethode Cast<TResult> Konvertiert die Elemente eines IEnumerable in den angegebenen Typ. (Durch Enumerable definiert.)
Öffentliche Erweiterungsmethode OfType<TResult> Filtert die Elemente eines IEnumerable anhand eines angegebenen Typs. (Durch Enumerable definiert.)
Zum Seitenanfang
  Name Beschreibung
Explizite Schnittstellenimplementierung Private Methode ICollection.CopyTo Infrastruktur. Kopiert alle Elemente aus dem TreeNodeCollection-Objekt in ein kompatibles eindimensionales System.Array, wobei bei dem angegebenen Index des Zielarrays begonnen wird.
Explizite Schnittstellenimplementierung Private Eigenschaft IStateManager.IsTrackingViewState Infrastruktur. Ruft einen Wert ab, der angibt, ob das TreeNodeCollection-Objekt Änderungen des Ansichtszustands speichert.
Explizite Schnittstellenimplementierung Private Methode IStateManager.LoadViewState Infrastruktur. Lädt den zuvor gespeicherten Ansichtszustand des TreeNodeCollection-Objekts.
Explizite Schnittstellenimplementierung Private Methode IStateManager.SaveViewState Infrastruktur. Speichert die Änderungen am Ansichtszustand in einem System.Object.
Explizite Schnittstellenimplementierung Private Methode IStateManager.TrackViewState Infrastruktur. Weist die TreeNodeCollection an, Änderungen am Ansichtszustand nachzuverfolgen.
Zum Seitenanfang

Die TreeNodeCollection-Klasse wird zum Speichern und Verwalten einer Auflistung von TreeNode-Objekten im TreeView-Steuerelement verwendet. Das TreeView-Steuerelement verwendet in zwei seiner Eigenschaften die TreeNodeCollection-Klasse. Es speichert seine Stammknoten in der Nodes-Eigenschaft und seine ausgewählten Knoten in der CheckedNodes-Eigenschaft. Die TreeNodeCollection-Auflistung wird auch für die ChildNodes-Eigenschaft verwendet, um ggf. vorhandene untergeordnete Knoten zu speichern.

Die TreeNodeCollection-Klasse unterstützt mehrere Möglichkeiten für den Zugriff auf die in der Auflistung enthaltenen Elemente:

  • Verwenden Sie den Item-Indexer, um ein TreeNode-Objekt direkt an einem bestimmten nullbasierten Index abzurufen.

  • Verwenden Sie die GetEnumerator-Methode zum Erstellen eines Enumerators, der zum Durchlaufen der Auflistung verwendet werden kann.

  • Mit foreach (C#) bzw. For Each (Visual Basic) kann die Auflistung durchlaufen werden.

  • Kopieren Sie mithilfe der CopyTo-Methode den Inhalt der Auflistung in ein Array-Objekt.

Sie können die TreeNodeCollection durch Hinzufügen und Entfernen von TreeNode-Objekten programmgesteuert verwalten. Fügen Sie der Auflistung mithilfe der Add-Methode oder der AddAt-Methode Knoten hinzu. Wenn Sie Knoten aus der Auflistung entfernen möchten, verwenden Sie eine der Methoden Remove, RemoveAt oder Clear.

Hinweis Hinweis

Wenn das TreeView-Steuerelement an eine Datenquelle gebunden ist, werden die Nodes-Auflistung und die ChildNodes-Auflistung bei jedem Bindevorgang automatisch aufgefüllt. Sämtliche zwischen den Bindungsvorgängen vorgenommenen Änderungen an den Auflistungen gehen verloren. Um diese Änderungen beizubehalten, aktualisieren Sie die Datenquelle, oder erstellen Sie die Auflistung bei jedem Bindevorgang manuell neu.

Die TreeNodeCollection enthält Eigenschaften und Methoden, mit deren Hilfe Sie Informationen zur Auflistung selbst abrufen können. Mit der Count-Eigenschaft können Sie ermitteln, wie viele Elemente in der Auflistung enthalten sind. Wenn Sie ermitteln möchten, ob die Auflistung ein bestimmtes TreeNode-Objekt enthält, verwenden Sie die Contains-Methode. Der Index eines TreeNode-Objekts in der Auflistung kann mithilfe der IndexOf-Methode abgerufen werden.

Im folgenden Beispiel wird veranschaulicht, wie einer TreeNodeCollection programmgesteuert Knoten hinzugefügt bzw. Knoten aus dieser entfernt werden. Beachten Sie, dass die Nodes-Eigenschaft und die ChildNodes-Eigenschaft ein TreeNodeCollection-Objekt zurückgeben.

C#
VB
Kopieren 


<%@ 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>

.NET Framework

Unterstützt in: 4, 3.5, 3.0, 2.0

Windows 7, Windows Vista SP1 oder höher, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core wird nicht unterstützt), Windows Server 2008 R2 (Server Core wird mit SP1 oder höher unterstützt), Windows Server 2003 SP2

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.
Alle öffentlichen static (Shared in Visual Basic)-Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.
Fanden Sie dies hilfreich?
(1500 verbleibende Zeichen)
Community-Inhalt Hinzufügen
Anmerkungen FAQ