Control.Controls Control.Controls Control.Controls Control.Controls Property

定義

UI 階層内の指定されたサーバー コントロールの子コントロールを表す ControlCollection オブジェクトを取得します。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; }
member this.Controls : System.Web.UI.ControlCollection
Public Overridable ReadOnly Property Controls As ControlCollection

プロパティ値

指定されたサーバー コントロールの子コントロールのコレクション。The collection of child controls for the specified server control.

次の例では、 ControlCollection Controlsプロパティを使用して、サーバーコントロールのオブジェクトに子コントロールを追加する方法を示します。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: "))
  

注釈

ASP.NET ページでは、サーバーコントロールの開始タグと終了タグの間にコントロールが宣言によって追加されると、ASP.NET は、そのコントロールControlCollectionを、それを含んでいるサーバーコントロールのに自動的に追加します。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. サーバー上で処理されない HTML タグやテキスト文字列は、オブジェクトとLiteralControlして扱われます。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.

プロパティControlsを使用すると、任意のサーバーコントロールのControlCollectionクラスのインスタンスにプログラムでアクセスできます。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.

注意 (継承者)

Controlsプロパティをオーバーライドする場合は、必ずEnsureChildControls()メソッドを呼び出してください。When overriding the Controls property, be sure to call the EnsureChildControls() method. さらに、コントロールをプログラムによってコントロールコレクションに追加する予定がある場合は、オーバーライドCreateChildControls()されたメソッドにコントロールを追加することを検討してください。Furthermore, if you are planning to add controls to the controls collection programmatically, consider adding the controls in an overridden CreateChildControls() method.

適用対象

こちらもご覧ください