WebPartZone.GetInitialWebParts Metoda
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
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.WebPartCollectionProtected Friend Overrides Function GetInitialWebParts () As WebPartCollectionZwraca
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 WebPartelementu , zestaw kontrolek składniki Web Part owija kontrolkę obiektemGenericWebPart, co umożliwia kontrolce zachowanie kontrolki w WebPart czasie wykonywania.
Klasa WebPartZone implementuje metodę podstawową, zwracając zestaw kontrolek (jeśli istnieje), które są statycznie zadeklarowane w zestawie tagów w znacznikach <zonetemplate> strony składniki 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 Literal WebPartZone 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ął.