TreeView.OnTreeNodePopulate(TreeNodeEventArgs) Methode

  • Referenz

Definition

Namespace:
System.Web.UI.WebControls
Assembly:
System.Web.dll

Löst das TreeNodePopulate-Ereignis des TreeView-Steuerelements aus.

protected:
 virtual void OnTreeNodePopulate(System::Web::UI::WebControls::TreeNodeEventArgs ^ e);
protected virtual void OnTreeNodePopulate (System.Web.UI.WebControls.TreeNodeEventArgs e);
abstract member OnTreeNodePopulate : System.Web.UI.WebControls.TreeNodeEventArgs -> unit
override this.OnTreeNodePopulate : System.Web.UI.WebControls.TreeNodeEventArgs -> unit
Protected Overridable Sub OnTreeNodePopulate (e As TreeNodeEventArgs)

Parameter

e
TreeNodeEventArgs

Ein TreeNodeEventArgs, das Ereignisdaten enthält.

Hinweise

Manchmal ist es aufgrund der Datengröße oder benutzerdefinierter Inhalte, die von der Benutzereingabe abhängen, nicht praktikabel, die Struktur statisch vorzudefinieren. Aus diesem Fall unterstützt das Steuerelement die TreeView dynamische Knotenauffüllung. Wenn die PopulateOnDemand -Eigenschaft für einen Knoten auf truefestgelegt ist, wird dieser Knoten zur Laufzeit aufgefüllt, wenn der Knoten erweitert wird.

Legen Sie zum dynamischen Auffüllen eines Knotens zuerst die PopulateOnDemand -Eigenschaft für den Knoten auf fest true. Definieren Sie als Nächstes eine Ereignisbehandlungsmethode für das TreeNodePopulate Ereignis, das den Knoten programmgesteuert auffüllt. Eine typische Ereignisbehandlungsmethode ruft Knotendaten aus einer Datenquelle ab, platziert die Daten in einer Knotenstruktur und fügt die Knotenstruktur dann der ChildNodes Auflistung des aufgefüllten Knotens hinzu. Eine Knotenstruktur wird erstellt, indem der ChildNodes Auflistung eines übergeordneten Knotens Objekte hinzugefügt TreeNode werden.

Hinweis

Wenn die PopulateOnDemand -Eigenschaft für einen Knoten auf truefestgelegt ist, muss der Knoten dynamisch aufgefüllt werden. Sie können keinen anderen Knoten darunter deklarativ schachteln. Andernfalls tritt auf der Seite ein Fehler auf.

Unterstützte Browser (Microsoft Internet Explorer 4.0-kompatible Browser und höher) können auch die clientseitige Knotenauffüllung nutzen. Wenn diese Option aktiviert ist, kann das TreeView Steuerelement einen Knoten auf dem Client dynamisch auffüllen, wenn dieser Knoten erweitert wird, sodass keine Postbacks an den Server erforderlich sind. Weitere Informationen zur clientseitigen Knotenauffüllung finden Sie unter PopulateNodesFromClient.

Durch das Auslösen eines Ereignisses wird der Ereignishandler über einen Delegaten aufgerufen. Weitere Informationen zum Behandeln von Ereignissen finden Sie unter behandeln und Auslösen von Ereignissen.

Mit der OnTreeNodePopulate-Methode können auch abgeleitete Klassen das Ereignis ohne Anfügen eines Delegaten behandeln. Dies ist das bevorzugte Verfahren für die Behandlung des Ereignisses in einer abgeleiteten Klasse.

Hinweise für Vererber

Achten Sie beim Überschreiben der OnTreeNodePopulate(TreeNodeEventArgs) -Methode in einer abgeleiteten Klasse darauf, die OnTreeNodePopulate(TreeNodeEventArgs) -Methode für die Basisklasse aufzurufen, damit registrierte Delegaten das Ereignis empfangen.

Gilt für:

Weitere Informationen