Ereignisse des TreeView-Webserversteuerelements

Artikel
10/22/2014

Aktualisiert: November 2007

Das TreeView-Webserversteuerelement stellt mehrere Ereignisse bereit, die Sie programmieren können. Dadurch können Sie benutzerdefinierte Routinen ausführen, wann immer ein Ereignis ausgelöst wird.

Ereignisse

Die TreeViewSteuerelementereignisse werden nur dann ausgelöst, wenn ein Benutzer das Steuerelement verwendet, z. B. einen Knoten auswählt, erweitert oder reduziert. Sie werden nicht ausgelöst, wenn die Methoden zum Auswählen, Erweitern oder Reduzieren programmgesteuert aufgerufen werden. Wenn Sie z. B. die Expand-Methode aufrufen, wird kein Ereignis ausgelöst.

Die folgende Tabelle beschreibt die Ereignisse, die vom TreeView-Steuerelement unterstützt werden.

Ereignis	Beschreibung
TreeNodeCheckChanged	Wird ausgelöst, wenn ein Kontrollkästchen des TreeView-Steuerelements während der Übermittlung an den Server seinen Zustand ändert. Tritt einmal für jedes TreeNode-Objekt auf, das sich ändert.
SelectedNodeChanged	Wird ausgelöst, wenn ein Knoten im TreeView-Steuerelement ausgewählt wird.
TreeNodeExpanded	Wird ausgelöst, wenn ein Knoten im TreeView-Steuerelement erweitert wird.
TreeNodeCollapsed	Wird ausgelöst, wenn ein Knoten im TreeView-Steuerelement reduziert wird.
TreeNodePopulate	Wird ausgelöst, wenn ein Knoten, dessen PopulateOnDemand-Eigenschaft auf true festgelegt ist, im TreeView-Steuerelement erweitert wird.
TreeNodeDataBound	Wird ausgelöst, wenn ein Datenelement im TreeView-Steuerelement an einen Knoten gebunden wird.

Beispiel

Das SelectedNodeChanged-Ereignis

Das folgende Codebeispiel zeigt die Behandlung eines SelectedNodeChanged-Ereignisses und den Zugriff auf die SelectedNode-Eigenschaft, die das Ereignis ausgelöst hat. Es trägt den Text von MyLabel als Text der ToolTip-Eigenschaft des SelectedNode ein.

Protected Sub TreeView1_SelectedNodeChanged(ByVal sender As Object, ByVal e As System.EventArgs) Handles TreeView1.SelectedNodeChanged
    MyLabel.Text = TreeView1.SelectedNode.ToolTip

End Sub

protected void TreeView1_SelectedNodeChanged(object sender, EventArgs e)
{
    MyLabel.Text = TreeView1.SelectedNode.ToolTip;
}

Das TreeNodeExpanded-Ereignis und das TreeNodeCollapsed-Ereignis

Das folgende Codebeispiel zeigt die Behandlung des TreeNodeCollapsed-Ereignisses und des TreeNodeExpanded-Ereignisses sowie den anschließenden Zugriff auf das TreeNode-Objekt, das reduziert oder erweitert wurde.

Protected Sub TreeView1_TreeNodeCollapsed(ByVal sender As Object, ByVal e As System.Web.UI.WebControls.TreeNodeEventArgs) Handles TreeView1.TreeNodeCollapsed
    MyLabel.Text = "You collapsed the " & e.Node.Value & " node."
End Sub

Protected Sub TreeView1_TreeNodeExpanded(ByVal sender As Object, ByVal e As System.Web.UI.WebControls.TreeNodeEventArgs) Handles TreeView1.TreeNodeExpanded
    MyLabel.Text = "You expanded the " & e.Node.Value & " node."
End Sub

protected void TreeView1_TreeNodeCollapsed(object sender, TreeNodeEventArgs e)
{
    MyLabel.Text = "You collapsed the " + e.Node.Value + " node.";
}
protected void TreeView1_TreeNodeExpanded(object sender, TreeNodeEventArgs e)
{
    MyLabel.Text = "You expanded the " + e.Node.Value + " node.";
}

Das TreeNodePopulate-Ereignis

Das folgende Codebeispiel zeigt die Behandlung des TreeNodePopulate-Ereignisses und das anschließende programmgesteuerte Hinzufügen eines TreeNode-Objekts zur ChildNodes Auflistung des Knotens, der das Ereignis ausgelöst hat.

Protected Sub TreeView1_TreeNodePopulate(ByVal sender As Object, ByVal e As System.Web.UI.WebControls.TreeNodeEventArgs) Handles TreeView1.TreeNodePopulate
    e.Node.ChildNodes.Add(New TreeNode("New Node Populated on Demand"))
End Sub

protected void TreeView1_TreeNodePopulate(object sender, TreeNodeEventArgs e)
{
    e.Node.ChildNodes.Add(new TreeNode("New Node Populated on Demand"));
}