Diese Dokumentation wurde archiviert und wird nicht länger gepflegt.

TreeView.Nodes-Eigenschaft

Aktualisiert: November 2007

Ruft eine Auflistung der TreeNode-Objekte ab, die die Stammknoten im TreeView-Steuerelement darstellt.

Namespace:  System.Web.UI.WebControls
Assembly:  System.Web (in System.Web.dll)

[PersistenceModeAttribute(PersistenceMode.InnerProperty)]
public TreeNodeCollection Nodes { get; }
/** @property */
/** @attribute PersistenceModeAttribute(PersistenceMode.InnerProperty) */
public TreeNodeCollection get_Nodes()

public function get Nodes () : TreeNodeCollection

Eigenschaftenwert

Typ: System.Web.UI.WebControls.TreeNodeCollection
Eine TreeNodeCollection, die die Stammknoten in der TreeView enthält.

Rufen Sie mithilfe der Nodes-Eigenschaft ein TreeNodeCollection-Objekt ab, das alle Stammknoten in der Struktur enthält. Diese Auflistung wird normalerweise verwendet, um schnell alle Stammknoten zu durchlaufen oder um auf einen bestimmten Stammknoten in der Struktur zuzugreifen.

f3yzd4dt.alert_note(de-de,VS.90).gifHinweis:

Eine typische Baumstruktur verfügt nur über einen Stammknoten. Sie können dem TreeView-Steuerelement jedoch mehrere Stammknoten hinzufügen.

Die Nodes-Eigenschaft kann auch dazu verwendet werden, die Stammknoten in der Struktur programmgesteuert zu verwalten. In einer Auflistung können Sie TreeNode-Objekte hinzufügen, einfügen, entfernen und abrufen. Alle an der Auflistung vorgenommenen Aktualisierungen werden nach dem nächsten Roundtrip zum Server automatisch im TreeView-Steuerelement dargestellt.

Greifen Sie mithilfe der ChildNodes-Eigenschaft des Knotens auf die untergeordneten Knoten eines Stammknotens zu. Navigieren Sie mithilfe der ChildNodes-Eigenschaft jedes nachfolgenden übergeordneten Knotens durch die Knotenebenen.

Im folgenden Codebeispiel wird veranschaulicht, wie eine Struktur mithilfe der Nodes-Eigenschaft durchlaufen wird.


<%@ 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 the TreeView control contains any root nodes, perform a
    // preorder traversal of the tree and display the text of each node.
    if(LinksTreeView.Nodes.Count > 0)
    {

      // Iterate through the root nodes in the Nodes property.
      for(int i=0; i<LinksTreeView.Nodes.Count; i++)
      {

        // Display the nodes.
        DisplayChildNodeText(LinksTreeView.Nodes[i]);

      }

    }
    else
    {

      Message.Text = "The TreeView control does not have any nodes.";

    }

  }

  void DisplayChildNodeText(TreeNode node)
  {

    // Display the node's text value.
    Message.Text += node.Text + "<br />";

    // Iterate through the child nodes of the parent node passed into
    // this method and display their values.
    for(int i=0; i<node.ChildNodes.Count; i++)
    {

      // Recursively call the DisplayChildNodeText method to
      // traverse the tree and display all the child nodes.
      DisplayChildNodeText(node.ChildNodes[i]);

    }

  }

</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>TreeNodeCollection Count Example</title>
</head>
<body>
    <form id="form1" runat="server">

      <h3>TreeNodeCollection Count 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="Subtopic 1"/>
                  <asp:TreeNode Text="Subtopic 2"/>

                </asp:TreeNode>
                <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>

      <br /><br />

      <asp:Label id="Message"
        runat="server"/>

    </form>
  </body>
</html>



Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98

.NET Framework und .NET Compact Framework unterstützen nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.

.NET Framework

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