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() 寫的方法中新增控制項。

適用於

另請參閱