ControlCollection ControlCollection ControlCollection ControlCollection Class

Определение

Предоставляет контейнер для коллекции, позволяющей ASP.NET серверным элементам управления хранить список дочерних элементов управления.Provides a collection container that enables ASP.NET server controls to maintain a list of their child controls.

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
Наследование
ControlCollectionControlCollectionControlCollectionControlCollection
Производный
Реализации

Примеры

Следующий пример кода переопределяет Control.CreateChildControls метод для создания двух элементов управления — обоих экземпляров пользовательского класса с именем ChildControl, который имеет строковое свойство с именем Message.The following code example overrides the Control.CreateChildControls method to create two controls, both instances of the custom class named ChildControl, which has a string property named Message. При создании эти два элемента управления добавляются ControlCollectionв.When created, the two controls are added to the ControlCollection. Метод вызывается для каждого из этих элементов управления, чтобы добавить их в класс, содержащий эту Control.CreateChildControlsверсию. AddThe Add method is called on each of these controls to add them to the class that contains this version of Control.CreateChildControls. ChildControlsCreated Свойство имеетtrue значение, чтобы эти элементы управления не создавались снова без необходимости.The ChildControlsCreated property is set to true so that these controls will not be created again unnecessarily.


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 через свойство.You can access any of the properties and methods of the ControlCollection class through the Control.Controls property. Control Поскольку класс является базовым классом для всех серверных элементов управления ASP.NET, все серверные элементы управления наследуют это свойство.Since the Control class is the base class for all ASP.NET server controls, all server controls inherit this property.

Дополнительные сведения о коллекциях см. в разделе коллекции и структуры данных.For more information about collections, see Collections and Data Structures.

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

ControlCollection(Control) ControlCollection(Control) ControlCollection(Control) ControlCollection(Control)

Инициализация нового экземпляра класса ControlCollection для заданного родительского серверного элемента управления.Initializes a new instance of the ControlCollection class for the specified parent server control.

Свойства

Count Count Count Count

Возвращает количество серверных элементов управления в объекте ControlCollection указанного ASP.NET серверного элемента управления.Gets the number of server controls in the ControlCollection object for the specified ASP.NET server control.

IsReadOnly IsReadOnly IsReadOnly IsReadOnly

Получает значение, показывающее, является ли объект ControlCollection доступным только для чтения.Gets a value indicating whether the ControlCollection object is read-only.

IsSynchronized IsSynchronized IsSynchronized IsSynchronized

Возвращает значение, указывающее, является ли объект ControlCollection синхронизированным.Gets a value indicating whether the ControlCollection object is synchronized.

Item[Int32] Item[Int32] Item[Int32] Item[Int32]

Возвращает ссылку на серверный элемент управления в указанном расположении индекса в объекте ControlCollection.Gets a reference to the server control at the specified index location in the ControlCollection object.

Owner Owner Owner Owner

Возвращает ASP.NET серверный элемент управления, которому принадлежит объект ControlCollection.Gets the ASP.NET server control to which the ControlCollection object belongs.

SyncRoot SyncRoot SyncRoot SyncRoot

Возвращает объект, который может быть использован для синхронизации доступа к коллекции элементов управления.Gets an object that can be used to synchronize access to the collection of controls.

Методы

Add(Control) Add(Control) Add(Control) Add(Control)

Добавляет указанный объект Control в коллекцию.Adds the specified Control object to the collection.

AddAt(Int32, Control) AddAt(Int32, Control) AddAt(Int32, Control) AddAt(Int32, Control)

Добавляет указанный объект Control в коллекцию по указанному расположению индекса.Adds the specified Control object to the collection at the specified index location.

Clear() Clear() Clear() Clear()

Удаляет все элементы управления из объекта ControlCollection текущего серверного элемента управления.Removes all controls from the current server control's ControlCollection object.

Contains(Control) Contains(Control) Contains(Control) Contains(Control)

Определяет наличие указанных серверных элементов управления в объекте ControlCollection родительского серверного элемента управления.Determines whether the specified server control is in the parent server control's ControlCollection object.

CopyTo(Array, Int32) CopyTo(Array, Int32) CopyTo(Array, Int32) CopyTo(Array, Int32)

Копирует дочерние элементы управления, хранимые в объекте ControlCollection, в объект Array, начиная с индекса, указанного в Array.Copies the child controls stored in the ControlCollection object to an Array object, beginning at the specified index location in the Array.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Определяет, равен ли заданный объект текущему объекту.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetEnumerator() GetEnumerator() GetEnumerator() GetEnumerator()

Извлекает перечислитель, который используется для выполнения итерации в объекте ControlCollection.Retrieves an enumerator that can iterate through the ControlCollection object.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Служит хэш-функцией по умолчанию.Serves as the default hash function.

(Inherited from Object)
GetType() GetType() GetType() GetType()

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

(Inherited from Object)
IndexOf(Control) IndexOf(Control) IndexOf(Control) IndexOf(Control)

Извлекает индекс указанного объекта Control в коллекции.Retrieves the index of a specified Control object in the collection.

MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Создает неполную копию текущего объекта Object.Creates a shallow copy of the current Object.

(Inherited from Object)
Remove(Control) Remove(Control) Remove(Control) Remove(Control)

Удаляет указанный серверный элемент управления из объекта ControlCollection родительского серверного элемента управления.Removes the specified server control from the parent server control's ControlCollection object.

RemoveAt(Int32) RemoveAt(Int32) RemoveAt(Int32) RemoveAt(Int32)

Удаляет дочерний элемент управления из объекта ControlCollection по указанному индексу.Removes a child control, at the specified index location, from the ControlCollection object.

ToString() ToString() ToString() ToString()

Возвращает строку, представляющую текущий объект.Returns a string that represents the current object.

(Inherited from Object)

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

Cast<TResult>(IEnumerable) Cast<TResult>(IEnumerable) Cast<TResult>(IEnumerable) Cast<TResult>(IEnumerable)

Приводит элементы объекта IEnumerable к заданному типу.Casts the elements of an IEnumerable to the specified type.

OfType<TResult>(IEnumerable) OfType<TResult>(IEnumerable) OfType<TResult>(IEnumerable) OfType<TResult>(IEnumerable)

Выполняет фильтрацию элементов объекта IEnumerable по заданному типу.Filters the elements of an IEnumerable based on a specified type.

AsParallel(IEnumerable) AsParallel(IEnumerable) AsParallel(IEnumerable) AsParallel(IEnumerable)

Позволяет осуществлять параллельный запрос.Enables parallelization of a query.

AsQueryable(IEnumerable) AsQueryable(IEnumerable) AsQueryable(IEnumerable) AsQueryable(IEnumerable)

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

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

Дополнительно