ControlCollection Класс

Определение

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

Производный

System.Web.UI.EmptyControlCollection

System.Web.UI.HtmlControls.HtmlTable.HtmlTableRowControlCollection

System.Web.UI.HtmlControls.HtmlTableRow.HtmlTableCellControlCollection

System.Web.UI.WebControls.Table.RowControlCollection

System.Web.UI.WebControls.TableRow.CellControlCollection

Подробнее…

Реализации

ICollection IEnumerable

Примеры

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

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

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

• Control
• Page
• Controls
• Коллекции и структуры данных