WebControlAdapter クラス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
コントロール アダプターが割り当てられている Web コントロールの表示をカスタマイズして、既定のマークアップや特定のブラウザーに対する動作を変更します。
public ref class WebControlAdapter : System::Web::UI::Adapters::ControlAdapterpublic class WebControlAdapter : System.Web.UI.Adapters.ControlAdaptertype WebControlAdapter = class
inherit ControlAdapterPublic Class WebControlAdapter
Inherits ControlAdapter- 継承
- 派生
注釈
クラス WebControl は、Web コントロールの継承元の基本クラスです。 これは、すべての Web コントロールに共通する多くのプロパティを定義します。 詳細については、「WebControl」を参照してください。
オブジェクトは、ブラウザー固有またはマークアップ固有の処理を可能にするために、実行ライフ サイクルで特定のクラスまたは継承されたメソッドおよびイベントを置き WebControlAdapter WebControl 換えるコンポーネントです。 この.NET Frameworkクライアント要求ごとに、1 つのコントロール アダプターを派生 WebControl オブジェクトにマップします。
アダプターは、特定のブラウザーまたはブラウザーのクラスのコントロール動作を変更するか、何らかの機能で任意のフィルターとして機能します。 レンダリング動作の適応性の多くを、 クラスから派生した特殊なクラスにカプセル化 HtmlTextWriter できます。 そのため、多くのブラウザー クラスの動作に 1 つのアダプターを使用できる可能性があります。また、クラスに適応性を含めることで、コントロール アダプターを使用する必要が生じない可能性があります HtmlTextWriter 。
コントロール自体は、必ずしもアダプターを必要とするとは限りません。 コントロールが合成によって拡張される場合は、通常、子コントロールのアダプターで十分です。
各コントロールには、.browser 定義ファイルを介したアダプターへの明示的なマッピングがあります。 したがって、 の プロパティへのアクセスでは、.browser 定義ファイルから抽出された オブジェクトを使用して、制御するアダプターのマッピングの参照 Adapter WebControl HttpBrowserCapabilities を実行します。
処理中に、.NET Frameworkは、ターゲット固有の可能性があるコントロールのオーバーライド可能なメソッドへの呼び出しをインターセプトします。 コントロール アダプターがアタッチされている場合、関連付けられている.NET Frameworkメソッドが呼び出されます。 詳細については、「ControlAdapter」を参照してください。
のレンダリングは、通常、開始タグと終了タグ、および開始タグと終了タグの間のいくつかの内部マークアップ WebControl で構成されます。 タグは、 の作成時 WebControl に定義されます。 詳細については、「WebControl」を参照してください。
タグは、 メソッドと RenderBeginTag メソッド RenderEndTag によってそれぞれ生成されます。 内部マークアップは、 メソッドによって生成 RenderContents されます。
メソッド Render は、次の順序でメソッドを呼び出すことによって、すべてのマークアップを生成します。
プロパティ IsEnabled は、 とその true すべての親コントロール WebControl が有効になっている場合にのみ を返します。 プロパティ Control は、 への強く型指定された参照を返します WebControl 。
コンストラクター
| WebControlAdapter() |
WebControlAdapter クラスの新しいインスタンスを初期化します。 |
プロパティ
| Browser |
現在の HTTP 要求の作成元であるクライアントのブラウザー機能への参照を取得します。 (継承元 ControlAdapter) |
| Control |
このコントロール アダプターの割り当て先 Web コントロールへの参照を取得します。 |
| IsEnabled |
Web コントロールおよびそのすべての親コントロールが有効になっているかどうかを示す値を取得します。 |
| Page |
このアダプターに関連付けられたコントロールが配置されているページへの参照を取得します。 (継承元 ControlAdapter) |
| PageAdapter |
関連付けられたコントロールが配置されているページのページ アダプターへの参照を取得します。 (継承元 ControlAdapter) |
メソッド
| BeginRender(HtmlTextWriter) |
コントロールの表示前に呼び出されます。 派生アダプター クラスで、HTML ブラウザーには必要ではなくても特定のターゲットには必要な開始タグを生成します。 (継承元 ControlAdapter) |
| CreateChildControls() |
複合コントロールのターゲット固有の子コントロールを作成します。 (継承元 ControlAdapter) |
| EndRender(HtmlTextWriter) |
コントロールの表示後に呼び出されます。 派生アダプター クラスで、HTML ブラウザーには必要ではなくても特定のターゲットには必要な終了タグを生成します。 (継承元 ControlAdapter) |
| Equals(Object) |
指定されたオブジェクトが現在のオブジェクトと等しいかどうかを判断します。 (継承元 Object) |
| GetHashCode() |
既定のハッシュ関数として機能します。 (継承元 Object) |
| GetType() |
現在のインスタンスの Type を取得します。 (継承元 Object) |
| LoadAdapterControlState(Object) |
このコントロール アダプターに関連付けられたコントロールが配置されているページに対する以前の要求時に SaveAdapterControlState() によって保存された、アダプターのコントロール状態情報を読み込みます。 (継承元 ControlAdapter) |
| LoadAdapterViewState(Object) |
このコントロール アダプターに関連付けられたコントロールが配置されているページに対する以前の要求時に SaveAdapterViewState() によって保存された、アダプターのビューステートを読み込みます。 (継承元 ControlAdapter) |
| MemberwiseClone() |
現在の Object の簡易コピーを作成します。 (継承元 Object) |
| OnInit(EventArgs) |
関連付けられたコントロールの OnInit(EventArgs) メソッドをオーバーライドします。 (継承元 ControlAdapter) |
| OnLoad(EventArgs) |
関連付けられたコントロールの OnLoad(EventArgs) メソッドをオーバーライドします。 (継承元 ControlAdapter) |
| OnPreRender(EventArgs) |
関連付けられたコントロールの OnPreRender(EventArgs) メソッドをオーバーライドします。 (継承元 ControlAdapter) |
| OnUnload(EventArgs) |
関連付けられたコントロールの OnUnload(EventArgs) メソッドをオーバーライドします。 (継承元 ControlAdapter) |
| Render(HtmlTextWriter) |
コントロール アダプターがアタッチされるコントロール用にターゲット固有のマークアップを生成します。 |
| RenderBeginTag(HtmlTextWriter) |
対象のブラウザーに送信されるマークアップ内に Web コントロールの開始タグを作成します。 |
| RenderChildren(HtmlTextWriter) |
コントロール アダプターの割り当て先である複合コントロールに含まれる子コントロールのターゲット固有のマークアップを生成します。 (継承元 ControlAdapter) |
| RenderContents(HtmlTextWriter) |
コントロール アダプターの割り当て先である Web コントロールのターゲット固有の内部マークアップを生成します。 |
| RenderEndTag(HtmlTextWriter) |
対象のブラウザーに送信されるマークアップ内に Web コントロールの終了タグを作成します。 |
| SaveAdapterControlState() |
コントロール アダプターのコントロール状態情報を保存します。 (継承元 ControlAdapter) |
| SaveAdapterViewState() |
コントロール アダプターのビューステート情報を保存します。 (継承元 ControlAdapter) |
| ToString() |
現在のオブジェクトを表す文字列を返します。 (継承元 Object) |