Auswahl, Navigation und Kontrollkästchen im TreeView-Webserversteuerelement
Aktualisiert: November 2007
Sie können in ASP.NET mit dem TreeView-Steuerelement in einfacher Weise darauf reagieren, dass ein Benutzer auf einen Knoten klickt, oder das Verhalten eines Knotens so ändern, dass er sich wie ein Hyperlink verhält. Außerdem können Sie mithilfe des TreeView-Steuerelements Kontrollkästchen neben einzelnen Knoten anzeigen, damit die Benutzer mehrere Knoten gleichzeitig auswählen können.
Auswahl und Navigation
Jeder Knoten verfügt über eine Text-Eigenschaft und eine Value-Eigenschaft. Der Wert der Text-Eigenschaft wird im TreeView-Steuerelement angezeigt. Mit der Value-Eigenschaft können zusätzliche Daten über den Knoten gespeichert werden, beispielsweise die an das Postbackereignis des Knotens übergebenen Daten.
Per Mausklick auf einen Knoten des TreeView-Steuerelements wird entweder ein Auswahlereignis ausgelöst (über Postback) oder ein Wechsel zu einer anderen Seite. Wenn die href-Eigenschaft nicht festgelegt ist, wird durch Klicken auf einen Knoten das SelectedNodeChanged-Ereignis ausgelöst. Dieses kann dazu verwendet werden, benutzerdefinierte Funktionen zur Verfügung zu stellen. Sie können auch die Selected-Eigenschaft eines Knotens überprüfen, um zu bestimmen, ob er ausgewählt ist. Durch Festlegen dieser Eigenschaft auf den Wert true oder durch Aufrufen der Select-Methode wird der Knoten programmgesteuert ausgewählt.
Mit der SelectAction-Eigenschaft des Knotens können zudem Aktionen angegeben werden, die bei Mausklicks auf den Knoten ausgeführt werden (z. B. Erweitern/Reduzieren des Knotens). Um beim Mausklick auf einen Knoten zu einer anderen Seite zu wechseln anstatt ein SelectedNodeChanged-Ereignis auszulösen, legen Sie die href-Eigenschaft des Knotens auf einen anderen Wert als eine leere Zeichenfolge ("") fest.
Weitere Informationen über die Behandlung von Auswahlereignissen finden Sie unter SelectedNode. Weitere Informationen zum Navigationsmodus finden Sie unter href. Weitere Informationen über die Festlegung der href-Eigenschaft beim Binden von Daten finden Sie unter hrefField.
Kontrollkästchen
Wenn Sie den Benutzern ermöglichen möchten, mehrere Knoten auszuwählen, können Sie mit dem TreeView-Steuerelement Kontrollkästchen neben den Symbolen bestimmter Knoten anzeigen. Für welchen Knotentyp Kontrollkästchen angezeigt werden, können Sie in der ShowCheckBoxes-Eigenschaft durch den TreeNodeType-Wert festlegen. Bei TreeNodeType.None werden keine Kontrollkästchen angezeigt. Wenn Kontrollkästchen angezeigt werden, können Sie mithilfe des TreeNodeCheckChanged-Ereignisses eine benutzerdefinierte Routine ausführen, wenn sich zwischen den Übermittlungen zum Server der Zustand eines Kontrollkästchens ändert. Wenn die Seite zum nächsten Mal an den Server übermittelt wird, wird die CheckedNodes-Eigenschaft mit den ausgewählten Knoten aufgefüllt.
Das TreeView-Steuerelement stellt keine AutoPostBack-Eigenschaft zur Verfügung. Entsprechend müssen Sie zur Übermittlung der Kontrollkästchenauswahl ein Steuerelement wie das Button-Webserversteuerelement auf der Seite platzieren, das die entsprechenden Informationen an den Server sendet.
Weitere Informationen zur Verwendung von Kontrollkästchen mit dem TreeView-Steuerelement in ASP.NET finden Sie unter CheckBoxes.
Siehe auch
Konzepte
Auffüllen von Strukturknoten im TreeView-Webserversteuerelement