WebPartZone.GetInitialWebParts 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í.
Přepíše abstraktní základní metodu a získá počáteční sadu statických WebPart ovládacích prvků obsažených v šabloně zóny.
protected public:
override System::Web::UI::WebControls::WebParts::WebPartCollection ^ GetInitialWebParts();protected internal override System.Web.UI.WebControls.WebParts.WebPartCollection GetInitialWebParts ();override this.GetInitialWebParts : unit -> System.Web.UI.WebControls.WebParts.WebPartCollectionProtected Friend Overrides Function GetInitialWebParts () As WebPartCollectionNávraty
A WebPartCollection , který obsahuje všechny WebPart nebo jiné serverové ovládací prvky obsažené v šabloně zóny.
Poznámky
Metoda GetInitialWebParts poskytuje implementaci abstraktní základní GetInitialWebParts metody. Základní metoda neposkytuje žádnou implementaci, ale deklaruje metodu tak, aby odvozené třídy mohly přizpůsobit, jak budou získávat počáteční sadu ovládacích prvků, které patří do zóny, bez zohlednění změn přizpůsobení.
Pro každý ovládací prvek serveru, který se nachází v zóně, CreateWebPart je volána metoda. Pokud se ovládací prvek dědí přímo z WebPart třídy, jednoduše se přidá do kolekce zóny WebParts (a do podobné kolekce WebPartManager ovládacího prvku). Pokud ovládací prvek nedědí přímo z WebPart, sada ovládacích prvků webových částí zabalí ovládací prvek objektem GenericWebPart , který umožňuje, aby se ovládací prvek za běhu choval jako WebPart ovládací prvek.
Třída WebPartZone implementuje základní metodu vrácením sady ovládacích prvků (pokud existují), které jsou staticky deklarovány v rámci sady <zonetemplate> značek ve značkách stránky webových částí.
PlaceHolder Pokud je ovládací prvek deklarován v zóně, jsou přidány podřízené ovládací prvky tohoto ovládacího prvku, nikoli samotný ovládací prvek. Tato implementace umožňuje například vytvořit zónu WebPartZone na stránce předlohy a pak deklarovat jednotlivé WebPart nebo serverové ovládací prvky na stránce obsahu. Pokud deklarujete Literal ovládací prvky v WebPartZone zóně, budou ignorovány.
Poznámka
Počáteční kolekce ovládacích prvků vrácených metodou GetInitialWebParts se může lišit od skutečné kolekce ovládacích prvků za běhu v zóně po provedení přizpůsobení. Předpokládejme například, že máte webovou stránku se dvěma WebPartZone ovládacími prvky a první obsahuje uživatelský ovládací prvek s názvem User1 , který je staticky deklarován v rámci <zonetemplate> značek. Pokud uživatel načte stránku a přetáhne User1 do druhé zóny, pak User1 je stále součástí kolekce, která je vrácena voláním GetInitialWebParts metody pro první zónu, protože je deklarována v této zóně. Ale za běhu, když WebPartManager ovládací prvek načte data přizpůsobení, se ve skutečnosti zobrazí v druhé zóně, User1 kam je uživatel přetáhl.
