Control.Controls Property
Gets a ControlCollection object that represents the child controls for a specified server control in the UI hierarchy.
Namespace: System.Web.UI
Assembly: System.Web (in System.Web.dll)
Property Value
Type: System.Web.UI.ControlCollectionThe collection of child controls for the specified server control.
On an ASP.NET page, when controls are added declaratively between the opening and closing tags of a server control, ASP.NET automatically adds the controls to the containing server control's ControlCollection. Any HTML tags or text strings that are not processed on the server are treated as LiteralControl objects. These are added to the collection like other server controls.
The Controls property allows you programmatic access to the instance of the ControlCollection class for any server control. You can add controls to the collection, remove controls from the collection, or iterate through the server controls in the collection.
Notes to InheritorsWhen overriding the Controls property, be sure to call the EnsureChildControls method. Furthermore, if you are planning to add controls to the controls collection programmatically, consider adding the controls in an overridden CreateChildControls method.
| Topic | Location |
|---|---|
| How to: Create Templated ASP.NET User Controls | Building ASP .NET Web Applications |
| How to: Customize Individual Days in a Calendar Web Server Control | Building ASP .NET Web Applications |
| How to: Create Templated ASP.NET User Controls | Building ASP .NET Web Applications |
| How to: Customize Individual Days in a Calendar Web Server Control | Building ASP .NET Web Applications |
| How to: Add PlaceHolder Web Server Controls to a Web Forms Page (Visual Studio) | Building ASP .NET Web Applications in Visual Studio |
The following example demonstrates how to add child controls to a server control's ControlCollection object through its Controls property.
Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)
The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.
