TreeView.OnTreeNodePopulate(TreeNodeEventArgs) Metoda

Reference

Definice

Obor názvů:: System.Web.UI.WebControls

Sestavení:: System.Web.dll

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 -> unit

Protected Overridable Sub OnTreeNodePopulate (e As TreeNodeEventArgs)

Parametry

e: TreeNodeEventArgs

A TreeNodeEventArgs , který obsahuje data události.

Poznámky

Někdy není praktické staticky předdefinovat stromovou strukturu kvůli velikosti dat nebo vlastnímu obsahu, který závisí na vstupu uživatele. Z tohoto TreeView důvodu ovládací prvek podporuje soubor dynamických uzlů. PopulateOnDemand Pokud je vlastnost uzlu nastavena na truehodnotu , tento uzel se naplní za běhu při rozbalení uzlu.

Pokud chcete uzel naplnit dynamicky, nastavte PopulateOnDemand nejprve vlastnost uzlu na truehodnotu . 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í je do struktury uzlu a pak přidá strukturu uzlu do ChildNodes kolekce naplněného uzlu. 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 nastavená na truehodnotu , musí být uzel naplněn dynamicky. Nelze deklarativně vnořit jiný uzel pod něj; jinak dojde na stránce k chybě.

Podporované prohlížeče (prohlížeče kompatibilní s Microsoft Internet Explorerem 4.0 a novější) mohou také využívat počet uzlů na straně klienta. Pokud je tato možnost povolená, umožňuje TreeView ovládacímu prvku dynamicky naplnit uzel v klientovi, když je tento uzel rozbalený, což zabrání nutnosti odeslání zpět na server. Další informace o souboru uzlů na straně klienta najdete v tématu PopulateNodesFromClient.

Vyvolání události spustí obslužnou rutinu události prostřednictvím delegáta. Další informace o zpracování událostí najdete v tématu Zpracování a vyvolávání událostí.

Metoda OnTreeNodePopulate také umožňuje odvozeným třídám 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 zavolat metodu OnTreeNodePopulate(TreeNodeEventArgs) pro základní třídu, aby registrovaní delegáti obdrželi událost.

Platí pro

Sdílet prostřednictvím