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


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

Определение

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

Перегрузки

CatalogPartCollection()

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

CatalogPartCollection(ICollection)

Инициализирует новый экземпляр класса CatalogPartCollection, передавая в него коллекцию ICollection элементов управления CatalogPart.

CatalogPartCollection(CatalogPartCollection, ICollection)

Инициализирует новый экземпляр класса CatalogPartCollection, передавая коллекцию ICollection элементов управления CatalogPart, существующих в зоне, и дополнительную коллекцию элементов управления.

Комментарии

Зона CatalogZoneBase , содержащая CatalogPart элементы управления, обычно является элементом управления, который создает CatalogPartCollection объект с помощью CreateCatalogParts метода . Однако вы также можете создать собственный CatalogPartCollection объект для других программных целей.

CatalogPartCollection()

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

public:
 CatalogPartCollection();
public CatalogPartCollection ();
Public Sub New ()

Комментарии

Конструктор CatalogPartCollection инициализирует пустой CatalogPartCollection экземпляр класса . Эта перегрузка конструктора используется внутри класса в методе CatalogZoneCreateCatalogParts для создания пустого объекта коллекции. Затем зона создает экземпляры всех CatalogPart элементов управления, объявленных в шаблоне дочерней зоны, и использует внутренний метод коллекции для их добавления.

Эту перегрузку конструктора CatalogPartCollection нельзя использовать для создания нового экземпляра CatalogPartCollection и добавления CatalogPart в него элементов управления. Вместо этого для конструктора CatalogPartCollection необходимо использовать одну из других перегрузок.

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

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

CatalogPartCollection(ICollection)

Инициализирует новый экземпляр класса CatalogPartCollection, передавая в него коллекцию ICollection элементов управления CatalogPart.

public:
 CatalogPartCollection(System::Collections::ICollection ^ catalogParts);
public CatalogPartCollection (System.Collections.ICollection catalogParts);
new System.Web.UI.WebControls.WebParts.CatalogPartCollection : System.Collections.ICollection -> System.Web.UI.WebControls.WebParts.CatalogPartCollection
Public Sub New (catalogParts As ICollection)

Параметры

catalogParts
ICollection

ICollection, состоящая из элементов управления CatalogPart.

Примеры

В следующем примере кода показано, как создать пользовательский CatalogPartCollectionобъект и выполнить пакетную операцию для изменения отдельных CatalogPart элементов управления в коллекции, даже если они доступны только для чтения. Полный код, необходимый для выполнения примера, см. в разделе CatalogPartCollection Пример раздела обзора класса.

Код в методе Button1_Click создает ArrayList объект , добавляет два CatalogPart элемента управления на странице в объект , а затем создает новый CatalogPartCollection объект с помощью конструктора CatalogPartCollection . В нем также показано, как можно вносить пакетные изменения в базовые CatalogPart элементы управления, даже если сама коллекция доступна только для чтения. Код выполняет цикл по коллекции, обновляя Description свойство каждого элемента управления.

protected void Button1_Click(object sender, EventArgs e)
{
  ArrayList list = new ArrayList(2);
  list.Add(PageCatalogPart1);
  list.Add(DeclarativeCatalogPart1);
  // Pass an ICollection object to the constructor.
  CatalogPartCollection myParts = new CatalogPartCollection(list);
  foreach (CatalogPart catalog in myParts)
  {
    catalog.Description = "My " + catalog.DisplayTitle;
  }

  // Use the IndexOf property to locate a CatalogPart control.
  int PageCatalogPartIndex = myParts.IndexOf(PageCatalogPart1);
  myParts[PageCatalogPartIndex].ChromeType = PartChromeType.TitleOnly;

  // Use the Contains method to see if a CatalogPart control exists.
  if (myParts.Contains(PageCatalogPart1))
  {
    WebPart closedWebPart = null;
    WebPartDescriptionCollection descriptions = PageCatalogPart1.GetAvailableWebPartDescriptions();
    if (descriptions.Count > 0)
    {
      closedWebPart = PageCatalogPart1.GetWebPart(descriptions[0]);
      closedWebPart.AllowClose = false;
    }
  }
  
  // Use indexers to display the details of the CatalogPart controls.
  Label1.Text = String.Empty;
  Label1.Text =
    "<h3>PageCatalogPart Details</h3>" +
    "ID: " + myParts[0].ID + "<br />" +
    "Count: " + myParts[0].GetAvailableWebPartDescriptions().Count;
  Label1.Text += 
    "<h3>DeclarativeCatalogPart Details</h3>" +
    "ID: " + myParts["DeclarativeCatalogPart1"].ID + "<br />" +
    "Count: " + myParts["DeclarativeCatalogPart1"].GetAvailableWebPartDescriptions().Count;
}
Protected Sub Button1_Click(ByVal sender As Object, ByVal e As EventArgs) 
    Dim list As New ArrayList(2)
    list.Add(PageCatalogPart1)
    list.Add(DeclarativeCatalogPart1)
    ' Pass an ICollection object to the constructor.
    Dim myParts As New CatalogPartCollection(list)
    Dim catalog As CatalogPart
    For Each catalog In  myParts
        catalog.Description = "My " + catalog.DisplayTitle
    Next catalog
    
    ' Use the IndexOf property to locate a CatalogPart control.
    Dim PageCatalogPartIndex As Integer = _
      myParts.IndexOf(PageCatalogPart1)
    myParts(PageCatalogPartIndex).ChromeType = PartChromeType.TitleOnly
    
    ' Use the Contains method to see if a CatalogPart control exists.
    If myParts.Contains(PageCatalogPart1) Then
        Dim closedWebPart As WebPart = Nothing
        Dim descriptions As WebPartDescriptionCollection = _
          PageCatalogPart1.GetAvailableWebPartDescriptions()
        If descriptions.Count > 0 Then
            closedWebPart = PageCatalogPart1.GetWebPart(descriptions(0))
            closedWebPart.AllowClose = False
        End If
    End If
    
    ' Use indexers to display the details of the CatalogPart controls.
    Label1.Text = String.Empty
    Label1.Text = _
      "<h3>PageCatalogPart Details</h3>" & _
      "ID: " & myParts(0).ID + "<br />" & _
      "Count: " & myParts(0).GetAvailableWebPartDescriptions().Count
    Label1.Text += _
      "<h3>DeclarativeCatalogPart Details</h3>" & _
      "ID: " & myParts("DeclarativeCatalogPart1").ID & "<br />" & _
      "Count: " & myParts("DeclarativeCatalogPart1") _
        .GetAvailableWebPartDescriptions().Count

End Sub 

При загрузке страницы в браузере можно переключить страницу в режим каталога, выбрав Каталог в раскрывающемся списке Режим отображения . Нажатие кнопки Display CatalogPart Properties позволяет получить доступ к объекту CatalogPartCollection и отобразить определенные свойства содержащихся CatalogPart элементов управления. Кроме того, если навести указатель мыши на текст заголовка в пределах границы DeclarativeCatalogPart элемента управления, вы увидите новый текст описания, добавленный в элемент управления при нажатии кнопки (описание отображается в подсказке). Если щелкнуть ссылку Каталог страниц для отображения PageCatalogPart элемента управления, вы увидите, что он также содержит обновленное описание.

Комментарии

Конструктор CatalogPartCollection инициализирует экземпляр CatalogPartCollection класса и передает коллекцию CatalogPart элементов управления. Это одна перегрузка конструктора CatalogPartCollection , которую можно использовать для создания нового CatalogPartCollection объекта и добавления CatalogPart в него элементов управления.

Хотя экземпляр, CatalogPartCollection созданный конструктором, доступен только для чтения, вы по-прежнему можете программно обращаться к отдельным CatalogPart элементам управления в коллекции и вызывать их свойства и методы.

Один из распространенных сценариев использования этого конструктора — выполнение пакетной операции со всем набором элементов управления, например изменение содержимого CatalogPart , внешнего вида или положения связанной группы элементов.

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

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

CatalogPartCollection(CatalogPartCollection, ICollection)

Инициализирует новый экземпляр класса CatalogPartCollection, передавая коллекцию ICollection элементов управления CatalogPart, существующих в зоне, и дополнительную коллекцию элементов управления.

public:
 CatalogPartCollection(System::Web::UI::WebControls::WebParts::CatalogPartCollection ^ existingCatalogParts, System::Collections::ICollection ^ catalogParts);
public CatalogPartCollection (System.Web.UI.WebControls.WebParts.CatalogPartCollection existingCatalogParts, System.Collections.ICollection catalogParts);
new System.Web.UI.WebControls.WebParts.CatalogPartCollection : System.Web.UI.WebControls.WebParts.CatalogPartCollection * System.Collections.ICollection -> System.Web.UI.WebControls.WebParts.CatalogPartCollection
Public Sub New (existingCatalogParts As CatalogPartCollection, catalogParts As ICollection)

Параметры

existingCatalogParts
CatalogPartCollection

Коллекция ICollection элементов управления CatalogPart, существующих в зоне.

catalogParts
ICollection

Коллекция ICollection дополнительных элементов управления CatalogPart.

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

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