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

.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

public class WebControlAdapter : ControlAdapter

C++

public ref class WebControlAdapter : public
 ControlAdapter

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 メソッドは、次の順序で各メソッドを呼び出して、すべてのマークアップを生成します。

RenderBeginTag
RenderContents
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) メンバはすべて、スレッドセーフです。インスタンスメンバの場合は、スレッドセーフであるとは限りません。