WebPartZone.GetInitialWebParts Metod
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
Åsidosätter den abstrakta basmetoden och hämtar den första uppsättningen statiska WebPart kontroller som finns i zonens mall.
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 WebPartCollectionReturer
En WebPartCollection som innehåller alla WebPart eller andra serverkontroller som finns i zonens mall.
Kommentarer
Metoden GetInitialWebParts tillhandahåller en implementering av den abstrakta basmetoden GetInitialWebParts . Basmetoden tillhandahåller ingen implementering, men deklarerar metoden så att härledda klasser kan anpassa hur de ska få den första uppsättningen kontroller som hör hemma i en zon, utan att hänsyn tas till anpassningsändringar.
För varje serverkontroll som finns i zonen CreateWebPart anropas metoden. Om en kontroll ärver direkt från WebPart klassen läggs den helt enkelt till i zonens WebParts samling (och till en liknande samling av WebPartManager kontrollen). Om en kontroll inte ärver direkt från WebPartomsluter kontrolluppsättningen webbdelar kontrollen med ett GenericWebPart objekt, vilket gör att kontrollen kan fungera som en WebPart kontroll vid körning.
Klassen WebPartZone implementerar basmetoden genom att returnera den uppsättning kontroller (om några) som statiskt deklareras inom en uppsättning <zonetemplate> taggar i markering av en webbdelssida. Om en PlaceHolder kontroll deklareras i en zon läggs de underordnade kontrollerna till i den kontrollen i stället för själva kontrollen. Med den här implementeringen kan du till exempel skapa en WebPartZone zon på en huvudsida och sedan deklarera enskilda WebPart kontroller eller serverkontroller på en innehållssida. Om du deklarerar Literal kontroller i en WebPartZone zon ignoreras de.
Note
Den första samlingen kontroller som returneras av GetInitialWebParts metoden kan skilja sig från den faktiska körningssamlingen av kontroller i en zon efter att anpassningen har ägt rum. Anta till exempel att du har en webbsida med två WebPartZone kontroller och den första innehåller användarkontroll med namnet User1 som statiskt deklareras i taggarna <zonetemplate> . Om en användare läser in sidan och drar User1 till den andra zonen User1 är den fortfarande en del av samlingen som returneras genom att anropa GetInitialWebParts metoden för den första zonen, eftersom den deklareras i den zonen. Men vid körningen, när WebPartManager kontrollen läser in anpassningsdata, User1 visas faktiskt i den andra zonen där användaren drog dem.
