Control.Controls 属性

定义

获取 ControlCollection 对象,该对象表示 UI 层次结构中的指定服务器控件的子控件。

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.ControlCollection
Public Overridable ReadOnly Property Controls As ControlCollection

属性值

ControlCollection

指定服务器控件的子控件的集合。

属性

示例

以下示例演示如何通过其Controls属性将子控件添加到服务器控件ControlCollection的对象。

Controls.Add(new LiteralControl("<h3>Value: "));
Controls.Add(New LiteralControl("<h3>Value: "))
  

注解

在 ASP.NET 页上,当在服务器控件的开始标记和结束标记之间以声明方式添加控件时,ASP.NET 会自动将控件添加到包含的服务器控件。ControlCollection 服务器上未处理的任何 HTML 标记或文本字符串都被视为 LiteralControl 对象。 这些控件会像其他服务器控件一样添加到集合中。

此属性 Controls 允许你以编程方式访问任何服务器控件的 ControlCollection 类实例。 可以将控件添加到集合、从集合中删除控件,或循环访问集合中的服务器控件。

继承者说明

重写 Controls 属性时,请务必调用 EnsureChildControls() 该方法。 此外,如果打算以编程方式将控件添加到控件集合,请考虑在重写 CreateChildControls() 的方法中添加控件。

适用于

另请参阅