WebPartZone.GetInitialWebParts 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.
Overschrijft de abstracte basismethode en haalt de eerste set statische WebPart besturingselementen op die zijn opgenomen in de sjabloon van de zone.
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 WebPartCollectionRetouren
Een WebPartCollection met alle WebPart of andere serverbesturingselementen in de sjabloon van de zone.
Opmerkingen
De GetInitialWebParts methode biedt een implementatie van de abstracte basismethode GetInitialWebParts . De basismethode biedt geen implementatie, maar declareert de methode, zodat afgeleide klassen kunnen aanpassen hoe ze de eerste set besturingselementen krijgen die deel uitmaken van een zone, zonder rekening te houden met persoonlijke wijzigingen.
Voor elk serverbeheer in de zone wordt de CreateWebPart methode aangeroepen. Als een besturingselement rechtstreeks van de WebPart klasse overgaat, wordt het gewoon toegevoegd aan de verzameling van WebParts de zone (en aan de vergelijkbare verzameling van het WebPartManager besturingselement). Als een besturingselement niet rechtstreeks van WebParteen besturingselement overdraagt, verpakt de besturingsset webonderdelen het besturingselement met een GenericWebPart object, waardoor het besturingselement zich tijdens runtime kan gedragen als een WebPart besturingselement.
De WebPartZone klasse implementeert de basismethode door de set besturingselementen (indien aanwezig) te retourneren die statisch zijn gedeclareerd binnen een set <zonetemplate> tags in de markering van een pagina met webonderdelen. Als een PlaceHolder besturingselement in een zone wordt gedeclareerd, worden de onderliggende besturingselementen van dat besturingselement toegevoegd in plaats van het besturingselement zelf. Met deze implementatie kunt u bijvoorbeeld een WebPartZone zone maken op een basispagina en vervolgens afzonderlijke WebPart besturingselementen of serverbesturingselementen declareren op een inhoudspagina. Als u besturingselementen in een Literal zone declareertWebPartZone, worden deze genegeerd.
Note
De eerste verzameling besturingselementen die door de GetInitialWebParts methode worden geretourneerd, kan afwijken van de werkelijke runtimeverzameling van besturingselementen in een zone, nadat persoonlijke instellingen zijn uitgevoerd. Stel dat u een webpagina met twee WebPartZone besturingselementen hebt en het eerste besturingselement gebruikersbesturingselement User1 bevat dat statisch is gedeclareerd binnen de <zonetemplate> tags. Als een gebruiker de pagina laadt en naar de tweede zone sleept User1 , maakt het User1 nog steeds deel uit van de verzameling die wordt geretourneerd door de GetInitialWebParts methode voor de eerste zone aan te roepen, omdat deze in die zone wordt gedeclareerd. Maar tijdens runtime, wanneer het WebPartManager besturingselement de persoonlijke gegevens laadt, User1 wordt het daadwerkelijk weergegeven in de tweede zone waar de gebruiker het heeft gesleept.
