WebPartZoneCollection Конструкторы
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Инициализирует новый экземпляр класса WebPartZoneCollection.
Перегрузки
WebPartZoneCollection() |
Инициализирует пустой экземпляр класса WebPartZoneCollection. |
WebPartZoneCollection(ICollection) |
Инициализирует экземпляр класса WebPartZoneCollection посредством передачи коллекции объектов WebPartZone. |
Комментарии
Конструктор WebPartZoneCollection используется элементом WebPartManager управления, другими элементами управления в наборе элементов управления веб-частей или пользовательским кодом разработчика для создания доступной WebPartZone только для чтения коллекции элементов управления, существующих на странице веб-частей.
WebPartZoneCollection()
Инициализирует пустой экземпляр класса WebPartZoneCollection.
public:
WebPartZoneCollection();
public WebPartZoneCollection ();
Public Sub New ()
Комментарии
Элемент WebPartManager управления использует этот конструктор в собственном конструкторе для инициализации нового экземпляра WebPartZoneCollection класса для страницы веб-частей.
См. также раздел
Применяется к
WebPartZoneCollection(ICollection)
Инициализирует экземпляр класса WebPartZoneCollection посредством передачи коллекции объектов WebPartZone.
public:
WebPartZoneCollection(System::Collections::ICollection ^ webPartZones);
public WebPartZoneCollection (System.Collections.ICollection webPartZones);
new System.Web.UI.WebControls.WebParts.WebPartZoneCollection : System.Collections.ICollection -> System.Web.UI.WebControls.WebParts.WebPartZoneCollection
Public Sub New (webPartZones As ICollection)
Параметры
- webPartZones
- ICollection
Коллекция ICollection объектов WebPartZone.
Исключения
Коллекция зон имеет значение null
.
Один из объектов в коллекции имеет значение null
или имеет тип, отличный от WebPartZone.
Примеры
В следующем примере кода демонстрируется использование конструктора WebPartZoneCollection . Полный код для примера можно найти в разделе Пример в обзоре WebPartZoneCollection класса.
Обратите внимание, что в следующем разделе кода объект назначается WebPartZoneCollection переменной путем получения значения Zones свойства . При необходимости вместо назначения всех зон из Zones свойства можно создать массив WebPartZoneBase объектов, содержащий подмножество всех зон на странице, и назначить массив новому WebPartZoneCollection объекту.
protected void Button5_Click(object sender, EventArgs e)
{
Label1.Text = String.Empty;
WebPartZoneCollection zoneCollection = mgr.Zones;
foreach (WebPartZone zone in zoneCollection)
{
if (zone.WebPartVerbRenderMode == WebPartVerbRenderMode.Menu)
zone.WebPartVerbRenderMode = WebPartVerbRenderMode.TitleBar;
else
zone.WebPartVerbRenderMode = WebPartVerbRenderMode.Menu;
}
}
Protected Sub Button5_Click(ByVal sender As Object, ByVal e As EventArgs)
Label1.Text = String.Empty
Dim zoneCollection As WebPartZoneCollection = mgr.Zones
Dim zone As WebPartZone
For Each zone In zoneCollection
If zone.WebPartVerbRenderMode = WebPartVerbRenderMode.Menu Then
zone.WebPartVerbRenderMode = WebPartVerbRenderMode.TitleBar
Else
zone.WebPartVerbRenderMode = WebPartVerbRenderMode.Menu
End If
Next zone
End Sub
После создания коллекции можно легко выполнить итерацию по коллекции и выполнить операции со всеми автономными зонами или их содержимым. Чтобы выполнить пример кода, загрузите страницу в браузере и нажмите кнопку Режим отрисовки команды в каждой зоне. Это чередуется с отображением глаголов в строке заголовка каждого серверного элемента управления, содержащегося в зоне. Команды могут отображаться в раскрывающемся меню или в виде ссылок в строке заголовка.
Комментарии
Используйте конструктор, WebPartZoneCollection когда требуется создать пользовательскую коллекцию WebPartZone объектов для выполнения с ними программных операций. Например, можно получить доступ к свойству Zones и создать подмножество WebPartZone объектов на странице веб-частей, назначив их объекту WebPartZoneCollection , а затем выполнить операции с дочерними элементами управления или различными свойствами только этого подмножества зон.