Sdílet prostřednictvím

TreeView.OnTreeNodePopulate(TreeNodeEventArgs) Metoda

  • Reference

Definice

Obor názvů:
System.Web.UI.WebControls
Sestavení:
System.Web.dll

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

Viz také