Gets a ControlCollection object that represents the child controls for a specified server control in the UI hierarchy.
(in System.Web.dll)
Visual Basic (Declaration)
<BrowsableAttribute(False)> _
Public Overridable ReadOnly Property Controls As ControlCollection
Dim instance As Control
Dim value As ControlCollection
value = instance.Controls
[BrowsableAttribute(false)]
public virtual ControlCollection Controls { get; }
[BrowsableAttribute(false)]
public:
virtual property ControlCollection^ Controls {
ControlCollection^ get ();
}
public function get Controls () : ControlCollection
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 Inheritors: When 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.
The following example demonstrates how to add child controls to a server control's ControlCollection object through its Controls property.
Controls.Add(New LiteralControl("<h3>Value: "))
Controls.Add(new LiteralControl("<h3>Value: "));
Controls.Add(new LiteralControl("<h3>Value: "));
pt]
this.Controls.Add(new LiteralControl("<h3>Value: "));
Windows 7, Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2008 R2, Windows Server 2008, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98
The .NET Framework and .NET Compact Framework do not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.
.NET Framework
Supported in: 3.5, 3.0, 2.0, 1.1, 1.0
Reference