ControlCollection Класс

Определение

Предоставляет контейнер для коллекции, позволяющей ASP.NET серверным элементам управления хранить список дочерних элементов управления.

public ref class ControlCollection : System::Collections::ICollection
public class ControlCollection : System.Collections.ICollection
type ControlCollection = class
    interface ICollection
    interface IEnumerable
Public Class ControlCollection
Implements ICollection
Наследование
ControlCollection
Производный
Реализации

Примеры

В следующем примере кода метод переопределяется Control.CreateChildControls для создания двух элементов управления— обоих экземпляров пользовательского класса с именем ChildControlstring, которое Messageимеет строковое свойство . При создании два элемента управления добавляются в ControlCollectionэлемент управления . Метод Add вызывается для каждого из этих элементов управления, чтобы добавить их в класс, содержащий эту версию Control.CreateChildControls. Свойству ChildControlsCreated true присвоено значение, чтобы эти элементы управления не создавались повторно.


protected override void CreateChildControls()
{               
   // Creates a new ControlCollection. 
   this.CreateControlCollection();

   // Create child controls.
    ChildControl firstControl = new ChildControl();
   firstControl.Message = "FirstChildControl";

   ChildControl secondControl = new ChildControl();
   secondControl.Message = "SecondChildControl";
   
   Controls.Add(firstControl);
   Controls.Add(secondControl);

   // Prevent child controls from being created again.
   ChildControlsCreated = true;
}

Protected Overrides Sub CreateChildControls()
   ' Creates a new ControlCollection. 
   Me.CreateControlCollection()
   
   ' Create child controls.
   Dim firstControl As New ChildControl()
   firstControl.Message = "FirstChildControl"
   
   Dim secondControl As New ChildControl()
   secondControl.Message = "SecondChildControl"
   
   Controls.Add(firstControl)
   Controls.Add(secondControl)
   
   ' Prevent child controls from being created again.
   ChildControlsCreated = True
End Sub


Комментарии

Доступ к любому из свойств и методов ControlCollection класса можно получить через Control.Controls свойство. Control Поскольку класс является базовым классом для всех ASP.NET серверных элементов управления, все серверные элементы управления наследуют это свойство.

Дополнительные сведения о коллекциях см. в разделе "Коллекции и структуры данных".

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

ControlCollection(Control)

Инициализация нового экземпляра класса ControlCollection для заданного родительского серверного элемента управления.

Свойства

Count

Возвращает количество серверных элементов управления в объекте ControlCollection указанного ASP.NET серверного элемента управления.

IsReadOnly

Получает значение, показывающее, является ли объект ControlCollection доступным только для чтения.

IsSynchronized

Возвращает значение, обозначающее, является ли объект ControlCollection синхронизированным.

Item[Int32]

Возвращает ссылку на серверный элемент управления в указанном расположении индекса в объекте ControlCollection.

Owner

Возвращает ASP.NET серверный элемент управления, которому принадлежит объект ControlCollection.

SyncRoot

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

Методы

Add(Control)

Добавляет указанный объект Control в коллекцию.

AddAt(Int32, Control)

Добавляет указанный объект Control в коллекцию по указанному расположению индекса.

Clear()

Удаляет все элементы управления из объекта ControlCollection текущего серверного элемента управления.

Contains(Control)

Определяет наличие указанных серверных элементов управления в объекте ControlCollection родительского серверного элемента управления.

CopyTo(Array, Int32)

Копирует дочерние элементы управления, хранимые в объекте ControlCollection, в объект Array, начиная с индекса, указанного в Array.

Equals(Object)

Определяет, равен ли указанный объект текущему объекту.

(Унаследовано от Object)
GetEnumerator()

Получает перечислитель, который может выполнять проход по объекту ControlCollection.

GetHashCode()

Служит хэш-функцией по умолчанию.

(Унаследовано от Object)
GetType()

Возвращает объект Type для текущего экземпляра.

(Унаследовано от Object)
IndexOf(Control)

Извлекает индекс указанного объекта Control в коллекции.

MemberwiseClone()

Создает неполную копию текущего объекта Object.

(Унаследовано от Object)
Remove(Control)

Удаляет указанный серверный элемент управления из объекта ControlCollection родительского серверного элемента управления.

RemoveAt(Int32)

Удаляет дочерний элемент управления из объекта ControlCollection по указанному индексу.

ToString()

Возвращает строку, представляющую текущий объект.

(Унаследовано от Object)

Методы расширения

Cast<TResult>(IEnumerable)

Приводит элементы объекта IEnumerable к заданному типу.

OfType<TResult>(IEnumerable)

Выполняет фильтрацию элементов объекта IEnumerable по заданному типу.

AsParallel(IEnumerable)

Позволяет осуществлять параллельный запрос.

AsQueryable(IEnumerable)

Преобразовывает коллекцию IEnumerable в объект IQueryable.

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

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