CompositeControl クラス

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

CompositeControl クラス

メモ : このクラスは、.NET Framework version 2.0 で新しく追加されたものです。

子コントロールを含んでいる Web コントロールに必要な基本機能を実装します。

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

Visual Basic (宣言)

Public MustInherit Class
 CompositeControl
    Inherits WebControl
    Implements INamingContainer, ICompositeControlDesignerAccessor

Visual Basic (使用法)

Dim instance As CompositeControl

C#

public abstract class CompositeControl : WebControl,
 INamingContainer, ICompositeControlDesignerAccessor

C++

public ref class CompositeControl abstract
 : public WebControl, INamingContainer, ICompositeControlDesignerAccessor

J#

public abstract class CompositeControl extends
 WebControl implements INamingContainer, ICompositeControlDesignerAccessor

JScript

public abstract class CompositeControl extends
 WebControl implements INamingContainer, ICompositeControlDesignerAccessor

解説

CompositeControl クラスは、子コントロール全体を包含したり、他のコントロールの機能を使用したりするカスタム コントロール用の名前付きのコンテナとコントロール デザイナの機能を提供する抽象クラスです。このクラスは、Login やWizard などのコントロールによって継承されます。このクラスを直接使用することはできません。

CompositeControl クラスは、INamingContainer インターフェイスを実装します。これは、すべての子コントロールの ID 属性が一意になるようにし、データ バインディングのポストバックに配置できるようにするために必要です。

カスタムの複合コントロールを作成するには、CompositeControl クラスを派生させます。このクラスが提供する機能は、アクセスされる前に子コントロールが作成されていることを確認する組み込みの検証機能で、これにより、デザイン時環境で子コントロールのコレクションを再作成できます。Controls プロパティは、ControlCollection へのアクセスの前に、すべての子コントロールが作成されていることを確認します。DataBind メソッドは、すべての子コントロールが、データ ソースにバインドされる前に作成されていることを検証します。

コントロールの開発者は、CompositeControlDesigner クラスを使用して、CompositeControl から派生した複合コントロールのカスタム デザイナを作成できます。コントロール デザイナは、デザイン ビューでのコントロールの表示および操作方法を定義するクラスです。詳細については、「CompositeControlDesigner」を参照してください。

Topic	Location
チュートリアル : Web サーバー コントロール用の基本的なコントロール デザイナの作成	ASP.NET コントロールの作成

.NET Framework のセキュリティ

• AspNetHostingPermission  (ホスト環境での動作に必要なアクセス許可)要求値 : LinkDemand; アクセス許可値 : Minimal。
• AspNetHostingPermission  (ホスト環境での動作に必要なアクセス許可)要求値 : InheritanceDemand; アクセス許可値 : Minimal。

継承階層

System.Object
   System.Web.UI.Control
     System.Web.UI.WebControls.WebControl
      System.Web.UI.WebControls.CompositeControl
         派生クラス

スレッド セーフ

この型の public static (Visual Basic では Shared) メンバはすべて、スレッド セーフです。インスタンス メンバの場合は、スレッド セーフであるとは限りません。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
CompositeControl メンバ
System.Web.UI.WebControls 名前空間
Controls
DataBind
CompositeControlDesigner