ControlCollection Класс

  • Ссылка

Определение

Пространство имен:
System.Web.UI
Сборка:
System.Web.dll

Предоставляет контейнер для коллекции, позволяющей 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
Наследование
Object
ControlCollection
Производный
Реализации
ICollection IEnumerable

Примеры

В следующем примере кода переопределяется Control.CreateChildControls метод для создания двух элементов управления, обоих экземпляров пользовательского класса с именем ChildControl, который имеет строковое свойство с именем 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.

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

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