ControlCollection クラス
ASP.NET サーバー コントロールが子コントロールのリストを維持できるようにする、コレクション コンテナを提供します。
名前空間: System.Web.UI
アセンブリ: System.Web (system.web.dll 内)
構文
'宣言
Public Class ControlCollection
Implements ICollection, IEnumerable
'使用
Dim instance As ControlCollection
public class ControlCollection : ICollection, IEnumerable
public ref class ControlCollection : ICollection, IEnumerable
public class ControlCollection implements ICollection, IEnumerable
public class ControlCollection implements ICollection, IEnumerable
適用できません。
解説
ControlCollection クラスの任意のプロパティおよびメソッドに、Control.Controls プロパティをとおしてアクセスできます。Control クラスはすべての ASP.NET サーバー コントロールの基本クラスであるため、すべてのサーバー コントロールは、このプロパティを継承します。
コレクションの詳細については、「コレクションとデータ構造体」を参照してください。
| トピック | 場所 |
|---|---|
| 方法 : Web フォーム ページに PlaceHolder Web サーバー コントロールを追加する (Visual Studio) | Visual Studio での ASP .NET Web アプリケーションの作成 |
| 方法 : Web フォーム ページに PlaceHolder Web サーバー コントロールを追加する (Visual Studio) | Visual Studio ASP .NET での Web アプリケーションの作成 |
| 方法 : コントロール コレクションをウォークしてページの Web フォーム コントロールを検索する | Visual Studio ASP .NET での Web アプリケーションの作成 |
| 方法 : プログラムによって ASP.NET ユーザー コントロールのインスタンスを作成する | Visual Studio ASP .NET での Web アプリケーションの作成 |
| 方法 : Web フォーム ページに PlaceHolder Web サーバー コントロールを追加する (Visual Studio) | Visual Studio ASP .NET での Web アプリケーションの作成 |
| 方法 : コントロール コレクションをウォークしてページの Web フォーム コントロールを検索する | Visual Studio ASP .NET での Web アプリケーションの作成 |
| 方法 : プログラムによって ASP.NET ユーザー コントロールのインスタンスを作成する | 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 に設定します。
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;
}
.NET Framework のセキュリティ
- AspNetHostingPermission (ホスト環境での動作に必要なアクセス許可)。要求値 : LinkDemand。アクセス許可値 : Minimal。
- AspNetHostingPermission (ホスト環境での動作に必要なアクセス許可)。要求値 : InheritanceDemand。アクセス許可値 : Minimal。
継承階層
System.Object
System.Web.UI.ControlCollection
派生クラス
スレッド セーフ
この型の public static (Visual Basicでは共有) メンバはすべて,スレッド セーフです。インスタンス メンバの場合は,スレッド セーフであるとは限りません。
プラットフォーム
Windows 98,Windows Server 2000 SP4,Windows CE,Windows Millennium Edition,Windows Mobile for Pocket PC,Windows Mobile for Smartphone,Windows Server 2003,Windows XP Media Center Edition,Windows XP Professional x64 Edition,Windows XP SP2,Windows XP Starter Edition
Microsoft .NET Framework 3.0 は Windows Vista,Microsoft Windows XP SP2,および Windows Server 2003 SP1 でサポートされています。
バージョン情報
.NET Framework
サポート対象 : 3.0,2.0,1.1,1.0
参照
関連項目
ControlCollection メンバ
System.Web.UI 名前空間
Control
Page
Control.Controls プロパティ