TreeView.OnTreeNodePopulate(TreeNodeEventArgs) Metoda
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
TreeNodePopulate Vyvolá událost TreeView ovládacího prvku.
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)Parametry
A TreeNodeEventArgs obsahující data událostí.
Poznámky
Někdy není praktické staticky předdefinovat strukturu stromové struktury z důvodu velikosti dat nebo vlastního obsahu, který závisí na vstupu uživatele. Z tohoto důvodu TreeView ovládací prvek podporuje dynamický počet obyvatel uzlů.
PopulateOnDemand Pokud je vlastnost uzlu nastavena na true, tento uzel se naplní za běhu při rozbalení uzlu.
Chcete-li naplnit uzel dynamicky, nejprve nastavte PopulateOnDemand vlastnost uzlu na true. Dále definujte metodu zpracování událostí pro TreeNodePopulate událost, která programově naplní uzel. Typická metoda zpracování událostí načte data uzlu ze zdroje dat, umístí data do struktury uzlu a pak přidá strukturu uzlu do ChildNodes kolekce uzlu, který se naplní. Struktura uzlu je vytvořena přidáním TreeNode objektů do ChildNodes kolekce nadřazeného uzlu.
Poznámka:
PopulateOnDemand Pokud je vlastnost uzlu nastavena na true, musí být uzel vyplněn dynamicky. Nelze deklarativní vnoření jiného uzlu pod ním; jinak na stránce dojde k chybě.
Podporované prohlížeče (prohlížeče kompatibilní s aplikací Microsoft Internet Explorer 4.0 a novější) můžou také využívat základní soubor uzlů na straně klienta. Pokud je tato možnost povolená, umožňuje ovládacímu TreeView prvku dynamicky naplnit uzel v klientovi při rozbalení tohoto uzlu, což zabrání nutnosti publikovat zpět na server. Další informace o populaci uzlů na straně klienta naleznete v tématu PopulateNodesFromClient.
Vyvolání události vyvolá obslužnou rutinu události prostřednictvím delegáta. Další informace o zpracování událostí naleznete v tématu Zpracování a vyvolávání událostí.
Metoda OnTreeNodePopulate také umožňuje odvozené třídy zpracovat událost bez připojení delegáta. Toto je upřednostňovaná technika pro zpracování události v odvozené třídě.
Poznámky pro dědice
Při přepsání OnTreeNodePopulate(TreeNodeEventArgs) metody v odvozené třídě nezapomeňte volat metodu OnTreeNodePopulate(TreeNodeEventArgs) pro základní třídu, aby registrovaní delegáti obdrželi událost.
