WebPartZone.GetInitialWebParts Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Переопределяет абстрактный базовый метод и получает исходный набор статических элементов управления 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.WebPartCollectionProtected Friend Overrides Function GetInitialWebParts () As 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 где пользователь перетаскивал их.
