Udostępnij za pośrednictwem


WebPartZone.GetInitialWebParts Metoda

Definicja

Zastępuje abstrakcyjną metodę bazową i pobiera początkowy zestaw kontrolek statycznych WebPart zawartych w szablonie strefy.

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

Zwraca

Element WebPartCollection zawierający wszystkie WebPart kontrolki lub inne kontrolki serwera zawarte w szablonie strefy.

Uwagi

Metoda GetInitialWebParts zapewnia implementację abstrakcyjnej metody bazowej GetInitialWebParts . Metoda podstawowa nie zapewnia implementacji, ale deklaruje metodę tak, aby klasy pochodne mogły dostosować sposób uzyskiwania początkowego zestawu kontrolek należących do strefy bez uwzględniania zmian personalizacji.

Dla każdej kontrolki serwera znalezionej w strefie wywoływana CreateWebPart jest metoda . Jeśli kontrolka dziedziczy bezpośrednio z WebPart klasy, jest po prostu dodawana do kolekcji strefy WebParts (i do podobnej kolekcji kontrolki WebPartManager ). Jeśli kontrolka nie dziedziczy bezpośrednio z WebPartzestawu składników Web Part, opakowuje kontrolkę obiektem GenericWebPart , co umożliwia kontrolce zachowanie kontrolki jako kontrolki WebPart w czasie wykonywania.

Klasa WebPartZone implementuje metodę podstawową, zwracając zestaw kontrolek (jeśli istnieją), które są statycznie zadeklarowane w zestawie tagów na adiustacji strony składników <zonetemplate> Web Part. Jeśli kontrolka PlaceHolder jest zadeklarowana w strefie, kontrolki podrzędne tej kontrolki są dodawane, a nie sama kontrolka. Ta implementacja umożliwia na przykład utworzenie WebPartZone strefy na stronie wzorcowej, a następnie zadeklarowanie poszczególnych WebPart kontrolek lub serwerów na stronie zawartości. W przypadku deklarowania LiteralWebPartZone kontrolek w strefie są ignorowane.

Uwaga

Początkowa kolekcja kontrolek zwracanych przez GetInitialWebParts metodę może się różnić od rzeczywistego zbierania kontrolek w czasie wykonywania w strefie po zakończeniu personalizacji. Załóżmy na przykład, że masz stronę sieci Web z dwoma WebPartZone kontrolkami, a pierwsza zawiera kontrolkę użytkownika o nazwie, User1 która jest statycznie zadeklarowana w <zonetemplate> tagach. Jeśli użytkownik ładuje stronę i przeciąga User1 ją do drugiej strefy, User1 nadal jest częścią kolekcji zwracanej przez wywołanie GetInitialWebParts metody dla pierwszej strefy, ponieważ jest zadeklarowana w tej strefie. Jednak w czasie wykonywania, gdy kontrolka WebPartManager ładuje dane personalizacji, faktycznie pojawia się w drugiej strefie, User1 w której użytkownik go przeciągnął.

Dotyczy

Zobacz też