TreeView.OnTreeNodePopulate(TreeNodeEventArgs) Methode
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Hiermee wordt de TreeNodePopulate gebeurtenis van het TreeView besturingselement gegenereerd.
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)Parameters
Een TreeNodeEventArgs met gebeurtenisgegevens.
Opmerkingen
Soms is het niet praktisch om statisch vooraf gedefinieerde structuur te maken vanwege de gegevensgrootte of aangepaste inhoud die afhankelijk is van gebruikersinvoer. Hierdoor ondersteunt het TreeView besturingselement dynamische knooppuntpopulatie. Wanneer de PopulateOnDemand eigenschap voor een knooppunt is ingesteld trueop, wordt dat knooppunt tijdens runtime ingevuld wanneer het knooppunt wordt uitgevouwen.
Als u een knooppunt dynamisch wilt vullen, stelt u eerst de PopulateOnDemand eigenschap voor het knooppunt in op true. Definieer vervolgens een methode voor gebeurtenisafhandeling voor de TreeNodePopulate gebeurtenis die het knooppunt programmatisch vult. Een typische methode voor gebeurtenisafhandeling haalt knooppuntgegevens op uit een gegevensbron, plaatst de gegevens in een knooppuntstructuur en voegt vervolgens de knooppuntstructuur toe aan de ChildNodes verzameling van het knooppunt dat wordt gevuld. Er wordt een knooppuntstructuur gemaakt door objecten toe te voegen TreeNode aan de ChildNodes verzameling van een bovenliggend knooppunt.
Note
Wanneer de PopulateOnDemand eigenschap voor een knooppunt is ingesteld trueop, moet het knooppunt dynamisch worden ingevuld. U kunt niet declaratief een ander knooppunt eronder nesten; anders treedt er een fout op de pagina op.
Ondersteunde browsers (Microsoft Internet Explorer met 4.0 compatibele browsers en hoger) kunnen ook profiteren van de populatie van knooppunten aan de clientzijde. Als dit is ingeschakeld, kan het TreeView besturingselement dynamisch een knooppunt op de client vullen wanneer dat knooppunt wordt uitgevouwen, waardoor de noodzaak om terug te posten naar de server wordt voorkomen. Zie voor meer informatie over de populatie PopulateNodesFromClientvan knooppunten aan de clientzijde.
Als u een gebeurtenis aanroept, wordt de gebeurtenis-handler via een gemachtigde aangeroepen. Zie Gebeurtenissen verwerken en genereren voor meer informatie over het afhandelen van gebeurtenissen.
Met OnTreeNodePopulate de methode kunnen afgeleide klassen de gebeurtenis ook verwerken zonder een gemachtigde te koppelen. Dit is de voorkeurstechniek voor het verwerken van de gebeurtenis in een afgeleide klasse.
Notities voor overnemers
Wanneer u de OnTreeNodePopulate(TreeNodeEventArgs) methode in een afgeleide klasse overschrijft, moet u de OnTreeNodePopulate(TreeNodeEventArgs) methode voor de basisklasse aanroepen, zodat geregistreerde gemachtigden de gebeurtenis ontvangen.
