Control.Controls 屬性
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
取得 ControlCollection 物件，表示 UI 階層架構中指定之伺服器控制項的子控制項。
public:
virtual property System::Web::UI::ControlCollection ^ Controls { System::Web::UI::ControlCollection ^ get(); };C#
[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 ControlCollection指定之伺服器控制項的子控制項集合。
- 屬性
下列範例示範如何透過其 Controls 屬性，將子控制項新增至伺服器控制項的物件 ControlCollection 。
C#
Controls.Add(new LiteralControl("<h3>Value: "));
Controls.Add(New LiteralControl("<h3>Value: "))
在 ASP.NET 網頁上，當在伺服器控制項的開頭和結束記號之間宣告方式新增控制項時，ASP.NET 會自動將控制項新增至包含伺服器控制項的 ControlCollection 。 伺服器上未處理的任何 HTML 標籤或文字字串都會被視為 LiteralControl 物件。 這些會新增至集合，就像其他伺服器控制項一樣。
屬性 Controls 可讓您以程式設計方式存取任何伺服器控制項的 ControlCollection 類別實例。 您可以將控制項新增至集合、從集合中移除控制項，或逐一查看集合中的伺服器控制項。
覆寫 Controls 屬性時，請務必呼叫 EnsureChildControls() 方法。 此外，如果您打算以程式設計方式將控制項新增至控制項集合，請考慮在覆 CreateChildControls() 寫的方法中新增控制項。
| 產品 | 版本 |
|---|---|
| .NET Framework | 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8 |