Control.Controls プロパティ
UI 階層構造の指定されたサーバー コントロールの子コントロールを表す ControlCollection オブジェクトを取得します。
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;
プロパティ値
指定されたサーバー コントロールの子コントロールのコレクション。
解説
ASP.NET ページでは、サーバー コントロールの開始タグと終了タグの間でコントロールを宣言して追加すると、ASP.NET は自動的にそのコントロールを、格納する側のサーバー コントロールの ControlCollection に追加します。サーバーで処理されない HTML タグまたは文字列は LiteralControl オブジェクトとして扱われます。これらは、他のサーバー コントロールと同様にコレクションに追加されます。
Controls プロパティは、任意のサーバー コントロールの ControlCollection クラスにプログラムによりアクセスできるようにします。コントロールをコレクションに追加したり、コレクションから削除できます。また、コレクションのサーバー コントロールを反復処理できます。
使用例
Controls プロパティを通じてサーバー コントロールの ControlCollection オブジェクトに子コントロールを追加する方法を次の例に示します。
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: "));
必要条件
プラットフォーム: Windows 2000, Windows XP Professional, Windows Server 2003 ファミリ
参照
Control クラス | Control メンバ | System.Web.UI 名前空間 | ControlCollection | CreateControlCollection | CreateChildControls