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