Поделиться через

WebPartZone.GetInitialWebParts Метод

  • Ссылка

Определение

Пространство имен:
System.Web.UI.WebControls.WebParts
Сборка:
System.Web.dll

Переопределяет абстрактный базовый метод и получает исходный набор статических элементов управления WebPart, содержащихся в шаблоне зоны.

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

Возвращаемое значение

WebPartCollection

Объект WebPartCollection, содержащий все элементы управления WebPart или другие серверные элементы управления, находящиеся в шаблоне зоны.

Комментарии

Метод GetInitialWebParts предоставляет реализацию абстрактного базового GetInitialWebParts метода. Базовый метод не предоставляет реализации, но объявляет метод , чтобы производные классы могли настроить способ получения начального набора элементов управления, принадлежащих зоне, без учета изменений персонализации.

Для каждого серверного элемента управления, найденного в зоне, CreateWebPart вызывается метод . Если элемент управления наследуется непосредственно от WebPart класса , он просто добавляется в коллекцию зоны WebParts (и в аналогичную коллекцию WebPartManager элемента управления). Если элемент управления не наследуется напрямую от WebPart, набор элементов управления веб-частей заключает элемент управления в GenericWebPart объект , что позволяет элементу управления вести себя как WebPart элемент управления во время выполнения.

Класс WebPartZone реализует базовый метод, возвращая набор элементов управления (если таковые имеются), которые статически объявлены в наборе тегов <zonetemplate> в разметке страницы веб-частей. Если элемент PlaceHolder управления объявлен в зоне, добавляются дочерние элементы управления этого элемента управления, а не сам элемент управления. Эта реализация позволяет, например, создать WebPartZone зону на главной странице, а затем объявить отдельные WebPart или серверные элементы управления на странице содержимого. При объявлении Literal элементов управления в WebPartZone зоне они игнорируются.

Примечание

Начальная коллекция элементов управления, возвращаемых методом GetInitialWebParts , может отличаться от фактической коллекции элементов управления во время выполнения в зоне после персонализации. Например, предположим, что у вас есть веб-страница с двумя WebPartZone элементами управления, а первый содержит пользовательский элемент управления с именем User1 , который статически объявлен в тегах <zonetemplate> . Если пользователь загружает страницу и перетаскивает User1 во вторую зону, то User1 по-прежнему является частью коллекции, возвращаемой путем вызова GetInitialWebParts метода для первой зоны, так как он объявлен в этой зоне. Но во время выполнения, когда WebPartManager элемент управления загружает данные персонализации, фактически отображается во второй зоне, User1 где пользователь перетаскивал их.

Применяется к

См. также раздел