WebControlAdapter クラス

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

WebControlAdapter クラス

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

コントロール アダプタが割り当てられている Web コントロールの表示をカスタマイズして、既定のマークアップや特定のブラウザに対する動作を変更します。

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

Visual Basic (宣言)

Public Class WebControlAdapter
    Inherits ControlAdapter

Visual Basic (使用法)

Dim instance As WebControlAdapter

C#

public class WebControlAdapter : ControlAdapter

C++

public ref class WebControlAdapter : public
 ControlAdapter

J#

public class WebControlAdapter extends ControlAdapter

JScript

public class WebControlAdapter extends
 ControlAdapter

解説

WebControl クラスは、Web コントロールの継承元である基本クラスです。このクラスは、すべての Web コントロールに共通の多数のプロパティを定義します。詳細については、「WebControl」を参照してください。

WebControlAdapter オブジェクトは、特定の WebControl クラス、またはブラウザ (またはマークアップ) 固有の処理ができるように実行有効期間中に継承されたメソッドやイベントを置き換えるコンポーネントです。.NET Framework は、単一のコントロール アダプタを、クライアント要求ごとに派生される WebControl オブジェクトに対応付けます。

アダプタは、特定のブラウザまたはブラウザのクラスについてコントロールの動作を変更したり、一部の機能に対しては任意のフィルタとして機能したりします。表示動作の適応性の多くは、HtmlTextWriter クラスから派生した特定のクラスにカプセル化できます。したがって、単一のアダプタをブラウザ クラスの複数の動作に使用することができ、また、HtmlTextWriter クラスに順応性を持たせることによってコントロール アダプタを使用する必要がなくなるとも言えます。

コントロール自体は、必ずしもアダプタを必要としません。コントロールがコンポジションを通じて拡張されている場合、通常は、子コントロールのアダプタで十分です。

各コントロールは、.browser 定義ファイルで明示的にアダプタに対応付けられます。そのため、アダプタとコントロールの対応付けに必要なルックアップを実行する場合、WebControl の Adapter プロパティに対するすべてのアクセスには、.browser 定義ファイルから抽出された HttpBrowserCapabilities オブジェクトが使用されます。

処理中に、.NET Framework が、ターゲット固有のコントロールのオーバーライド可能なメソッドの呼び出しを受け取ります。コントロール アダプタが割り当てられている場合、.NET Framework は、関連付けられているアダプタ メソッドを呼び出します。詳細については、「ControlAdapter」を参照してください。

WebControl の表示は、通常、開始タグ、終了タグ、および開始タグと終了タグの間に配置されるいくつかの内部マークアップで構成されます。これらのタグは、WebControl の作成時に定義されます。詳細については、「WebControl」を参照してください。

開始タグと終了タグは、それぞれ RenderBeginTag メソッドおよび RenderEndTag メソッドで生成されます。内部マークアップは、RenderContents メソッドで生成されます。

Render メソッドは、次の順序で各メソッドを呼び出して、すべてのマークアップを生成します。

1. RenderBeginTag

2. RenderContents

3. RenderEndTag

IsEnabled プロパティは、WebControl およびその親コントロールが有効な場合のみ、true を返します。Control プロパティは、WebControl コントロールへの、厳密に型指定されている参照を返します。

.NET Framework のセキュリティ

• AspNetHostingPermission  (WebControlAdapter の直接の呼び出し元にこのアクセス許可があるかどうかをコンパイル時に検査するために必要なアクセス許可) 関連する列挙体 : LinkDemand、Minimal
• AspNetHostingPermission  (WebControlAdapter から派生したクラスにこのアクセス許可があるかどうかを読み込み時に検査するために必要なアクセス許可) 関連する列挙体 : InheritanceDemand、Minimal

継承階層

System.Object
   System.Web.UI.Adapters.ControlAdapter
    System.Web.UI.WebControls.Adapters.WebControlAdapter
       System.Web.UI.WebControls.Adapters.DataBoundControlAdapter
       System.Web.UI.WebControls.Adapters.HideDisabledControlAdapter
       System.Web.UI.WebControls.Adapters.HierarchicalDataBoundControlAdapter
       System.Web.UI.WebControls.Adapters.MenuAdapter

スレッド セーフ

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

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, 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

参照

関連項目
WebControlAdapter メンバ
System.Web.UI.WebControls.Adapters 名前空間
ControlAdapter
WebControl クラス
Control