Freigeben über


WebPartZone.GetInitialWebParts Methode

Definition

Überschreibt die abstrakte Basismethode und ruft den anfänglichen Satz der statischen WebPart-Steuerelemente ab, der in der Vorlage der Zone enthalten ist.

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.WebPartCollection
Protected Friend Overrides Function GetInitialWebParts () As WebPartCollection

Gibt zurück

Eine WebPartCollection, die alle WebPart-Steuerelemente oder andere Serversteuerelemente in der Vorlage der Zone enthält.

Hinweise

Die GetInitialWebParts -Methode stellt eine Implementierung der abstrakten Basismethode GetInitialWebParts bereit. Die Basismethode stellt keine Implementierung bereit, deklariert aber die -Methode, sodass abgeleitete Klassen anpassen können, wie sie den anfänglichen Satz von Steuerelementen erhalten, die in eine Zone gehören, ohne Personalisierungsänderungen zu berücksichtigen.

Für jedes In der Zone gefundene Serversteuerelement wird die CreateWebPart -Methode aufgerufen. Wenn ein Steuerelement direkt von der WebPart -Klasse erbt, wird es einfach der Auflistung der Zone (und der ähnlichen Auflistung des WebPartManager SteuerelementsWebParts) hinzugefügt. Wenn ein Steuerelement nicht direkt von erbt WebPart, umschließt der Webpart-Steuerelementsatz das Steuerelement mit einem GenericWebPart -Objekt, wodurch sich das Steuerelement zur Laufzeit als WebPart Steuerelement verhalten kann.

Die WebPartZone -Klasse implementiert die Basismethode, indem sie den Satz von Steuerelementen (falls vorhanden) zurückgibt, die statisch innerhalb einer Gruppe von <zonetemplate> Tags im Markup einer Webpartseite deklariert werden. Wenn ein PlaceHolder Steuerelement in einer Zone deklariert wird, werden die untergeordneten Steuerelemente dieses Steuerelements und nicht das Steuerelement selbst hinzugefügt. Mit dieser Implementierung können Sie beispielsweise eine Zone in einer WebPartZone Gestaltungsvorlage erstellen und dann einzelne WebPart oder Serversteuerelemente auf einer Inhaltsseite deklarieren. Wenn Sie Steuerelemente in einer WebPartZone Zone deklarierenLiteral, werden diese ignoriert.

Hinweis

Die anfängliche Auflistung von Steuerelementen, die von der GetInitialWebParts -Methode zurückgegeben werden, kann sich von der tatsächlichen Laufzeitsammlung von Steuerelementen in einer Zone unterscheiden, nachdem die Personalisierung erfolgt ist. Angenommen, Sie verfügen über eine Webseite mit zwei WebPartZone Steuerelementen, und das erste enthält ein Benutzersteuerelement namens User1 , das statisch innerhalb der <zonetemplate> Tags deklariert wird. Wenn ein Benutzer die Seite lädt und in die zweite Zone zieht User1 , ist sie User1 weiterhin Teil der Auflistung, die durch Aufrufen der Methode für die GetInitialWebParts erste Zone zurückgegeben wird, da sie in dieser Zone deklariert wird. Aber zur Laufzeit, wenn das Steuerelement die WebPartManager Personalisierungsdaten lädt, wird tatsächlich in der zweiten Zone angezeigt, User1 in der der Benutzer es gezogen hat.

Gilt für:

Weitere Informationen