Control.Controls Property
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Gets a ControlCollection object that represents the child controls for a specified server control in the UI hierarchy.
public:
virtual property System::Web::UI::ControlCollection ^ Controls { System::Web::UI::ControlCollection ^ get(); };[System.ComponentModel.Browsable(false)]
public virtual System.Web.UI.ControlCollection Controls { get; }[<System.ComponentModel.Browsable(false)>]
member this.Controls : System.Web.UI.ControlCollectionPublic Overridable ReadOnly Property Controls As ControlCollectionProperty Value
The collection of child controls for the specified server control.
- Attributes
Examples
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: "))
Remarks
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.
