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

Ссылка

Определение

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

Сборка:: System.Web.dll

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Инициализирует новый экземпляр класса 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 экземпляр класса . Эта перегрузка конструктора используется классом CatalogZone в своем CreateCatalogParts методе для создания пустого объекта коллекции. Затем зона создает экземпляры всех CatalogPart элементов управления, объявленных в шаблоне дочерней зоны, и использует внутренний метод коллекции для их добавления.

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

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

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

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

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 элементов управления, например изменение содержимого, внешнего вида или положения связанной группы элементов.

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

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

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

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.

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

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

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

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

Определение

Перегрузки

Комментарии

CatalogPartCollection()

Комментарии

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

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

CatalogPartCollection(ICollection)

Параметры

Примеры

Комментарии

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

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

CatalogPartCollection(CatalogPartCollection, ICollection)

Параметры

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

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

Обратная связь

Дополнительные ресурсы