Export (0) Print
Expand All

Control.Controls Property

Gets a ControlCollection object that represents the child controls for a specified server control in the UI hierarchy.

[Visual Basic]
Public Overridable ReadOnly Property Controls As ControlCollection
[C#]
public virtual ControlCollection Controls {get;}
[C++]
public: __property virtual ControlCollection* get_Controls();
[JScript]
public function get Controls() : ControlCollection;

Property Value

The collection of child controls for the specified server control.

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.

Example

The following example demonstrates how to add child controls to a server control's ControlCollection object through its Controls property.

[Visual Basic] 
Controls.Add(New LiteralControl("<h3>Value: "))
  

[C#] 
Controls.Add(new LiteralControl("<h3>Value: "));

[C++] 
Controls->Add(new LiteralControl(S"<h3>Value: "));

[JScript] 
Controls.Add(new LiteralControl("<h3>Value: "));

Requirements

Platforms: Windows 2000, Windows XP Professional, Windows Server 2003 family

See Also

Control Class | Control Members | System.Web.UI Namespace | ControlCollection | CreateControlCollection | CreateChildControls

Show:
© 2014 Microsoft