WebPartZoneCollection Конструкторы

Определение

Пространство имен:

System.Web.UI.WebControls.WebParts

Сборка:

System.Web.dll

Инициализирует новый экземпляр класса WebPartZoneCollection.

Перегрузки

WebPartZoneCollection()	Инициализирует пустой экземпляр класса WebPartZoneCollection.
WebPartZoneCollection(ICollection)	Инициализирует экземпляр класса WebPartZoneCollection посредством передачи коллекции объектов WebPartZone.

Комментарии

Конструктор WebPartZoneCollection используется элементом WebPartManager управления, другими элементами управления в наборе элементов управления веб-частей или пользовательским кодом разработчика для создания доступной WebPartZone только для чтения коллекции элементов управления, существующих на странице веб-частей.

WebPartZoneCollection()

Инициализирует пустой экземпляр класса WebPartZoneCollection.

public:
 WebPartZoneCollection();

public WebPartZoneCollection ();

Public Sub New ()

Комментарии

Элемент WebPartManager управления использует этот конструктор в собственном конструкторе для инициализации нового экземпляра WebPartZoneCollection класса для страницы веб-частей.

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

• элементы управления веб-частей ASP.NET

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.

Исключения

ArgumentNullException

Коллекция зон имеет значение null.

ArgumentException

Один из объектов в коллекции имеет значение 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 , а затем выполнить операции с дочерними элементами управления или различными свойствами только этого подмножества зон.

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

• элементы управления веб-частей ASP.NET