ControlCollection クラスとは何？わかりやすく解説 Weblio辞書

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

ControlCollection クラス

ASP.NET サーバーコントロールが子コントロールのリストを維持できるようにする、コレクションコンテナを提供します。

名前空間: System.Web.UI
アセンブリ: System.Web (system.web.dll 内)
構文

Visual Basic (宣言)

Public Class ControlCollection
    Implements ICollection, IEnumerable

Visual Basic (使用法)

Dim instance As ControlCollection

public class ControlCollection : ICollection,
 IEnumerable

C++

public ref class ControlCollection : ICollection,
 IEnumerable

public class ControlCollection implements ICollection,
 IEnumerable

JScript

public class ControlCollection implements ICollection,
 IEnumerable

解説

ControlCollection クラスの任意のプロパティおよびメソッドに、Control.Controls プロパティをとおしてアクセスできます。Control クラスはすべての ASP.NET サーバーコントロールの基本クラスであるため、すべてのサーバーコントロールは、このプロパティを継承します。

コレクションの詳細については、「コレクションとデータ構造体」を参照してください。

Topic	Location
方法 : Web フォームページに PlaceHolder Web サーバーコントロールを追加する (Visual Studio)	Visual Studio での ASP .NET Web アプリケーションの作成
方法 : コントロールコレクションをウォークしてページの Web フォームコントロールを検索する	ASP .NET Web アプリケーションの作成
方法 : プログラムによって ASP.NET ユーザーコントロールのインスタンスを作成する	ASP .NET Web アプリケーションの作成

使用例

Control.CreateChildControls メソッドをオーバーライドして、2 つのコントロール (ChildControl という名前のカスタムクラスの 2 つのインスタンス) を作成するコード例を次に示します。これらのコントロールには、Message という名前の文字列プロパティが存在します。2 つのコントロールを、作成した後で ControlCollection に追加しています。このバージョンの Control.CreateChildControls を含むクラスにこれらのコントロールを追加するために、Add メソッドを各コントロールに対して呼び出しています。このコードではまた、作成したコントロールが不必要に再作成されることのないよう、ChildControlsCreated プロパティを true に設定します。

Visual Basic

Protected Overrides Sub
 CreateChildControls()
   ' Creates a new ControlCollection. 
   Me.CreateControlCollection()
   
   ' Create child controls.
   Dim firstControl As New
 ChildControl()
   firstControl.Message = "FirstChildControl"
   
   Dim secondControl As New
 ChildControl()
   secondControl.Message = "SecondChildControl"
   
   Controls.Add(firstControl)
   Controls.Add(secondControl)
   
   ' Prevent child controls from being created again.
   ChildControlsCreated = True
End Sub 'CreateChildControls

protected override void CreateChildControls()
{               
   // Creates a new ControlCollection. 
   this.CreateControlCollection();

   // Create child controls.
    ChildControl firstControl = new ChildControl();
   firstControl.Message = "FirstChildControl";

   ChildControl secondControl = new ChildControl();
   secondControl.Message = "SecondChildControl";
   
   Controls.Add(firstControl);
   Controls.Add(secondControl);

   // Prevent child controls from being created again.
   ChildControlsCreated = true;
}