TreeView.OnTreeNodePopulate(TreeNodeEventArgs) Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Löst das TreeNodePopulate Ereignis des Steuerelements TreeView 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 -> unitProtected Overridable Sub OnTreeNodePopulate (e As TreeNodeEventArgs)Parameter
Ein TreeNodeEventArgs Objekt, das Ereignisdaten enthält.
Hinweise
Manchmal ist es nicht praktisch, die Struktur aufgrund der Datengröße oder benutzerdefinierten Inhalte, die von der Benutzereingabe abhängig sind, statisch vorzudefinieren. Aus diesem Gründen unterstützt das Steuerelement die TreeView dynamische Knotenpopulation. Wenn die PopulateOnDemand Eigenschaft für einen Knoten auf true"festgelegt" festgelegt ist, wird dieser Knoten zur Laufzeit aufgefüllt, wenn der Knoten erweitert wird.
Um einen Knoten dynamisch aufzufüllen, legen Sie zuerst die PopulateOnDemand Eigenschaft für den Knoten auf 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 dann die Knotenstruktur der ChildNodes Auflistung des aufgefüllten Knotens hinzu. Eine Knotenstruktur wird durch Hinzufügen TreeNode von Objekten zur ChildNodes Auflistung eines übergeordneten Knotens erstellt.
Hinweis
Wenn die PopulateOnDemand Eigenschaft für einen Knoten auf "Festgelegt" festgelegt trueist, muss der Knoten dynamisch aufgefüllt werden. Sie können einen anderen Knoten darunter nicht deklarativ verschachteln; andernfalls tritt auf der Seite ein Fehler auf.
Unterstützte Browser (mit Microsoft Internet Explorer 4.0 kompatible Browser und höher) können auch die clientseitige Knotengesamtheit nutzen. Wenn diese Option aktiviert ist, kann das TreeView Steuerelement einen Knoten auf dem Client dynamisch auffüllen, wenn dieser Knoten erweitert wird, wodurch verhindert wird, dass die Bereitstellung auf dem Server erfolgt. Weitere Informationen zur clientseitigen Knotengesamtheit finden Sie unter PopulateNodesFromClient.
Das Auslösen eines Ereignisses ruft den Ereignishandler über einen Delegaten auf. Weitere Informationen zum Behandeln von Ereignissen finden Sie unter Behandeln und Auslösen von Ereignissen.
Mit der OnTreeNodePopulate Methode können abgeleitete Klassen auch das Ereignis behandeln, ohne einen Delegaten anzufügen. Dies ist die bevorzugte Technik 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 Stellvertretungen das Ereignis empfangen.
