XhtmlControlAdapter クラス
メモ : このクラスは、.NET Framework version 2.0 で新しく追加されたものです。
モバイル コントロールを XHTML マークアップでレンダリングするための既定のコントロール アダプタを提供します。
名前空間: System.Web.UI.MobileControls.Adapters.XhtmlAdapters
アセンブリ: System.Web.Mobile (system.web.mobile.dll 内)
構文
解説
.NET Framework のセキュリティ
継承階層
スレッド セーフ
プラットフォーム
バージョン情報
参照
アセンブリ: System.Web.Mobile (system.web.mobile.dll 内)
構文解説このクラスは、コントロールとその子をモバイル デバイス用に XHTML マークアップでレンダリングする基本のモバイル コントロール アダプタを提供します。また、このクラスは、派生した XHTML モバイル コントロール アダプタのヘルパー メソッドと共通プロパティも提供します。
コントロール アダプタは、Control クラスの特定のメソッドやイベントをオーバーライドして、ブラウザまたはマークアップ固有の処理ができるようにするコンポーネントです。レンダリング動作におけるアダプタ機能の多くは、XhtmlTextWriter クラスにカプセル化されています。独自にコントロール アダプタを作成する際は、ブラウザ クラスの複数の動作をオーバーライドする場合でも、使用できるアダプタは 1 つだけである点に注意してください。コントロール アダプタを使わなくても済むように、必要なアダプタ機能を XhtmlMobileTextWriter クラスの派生クラスで実装することもできます。
特定のコントロール クラスのアダプタは、専用のアダプタが存在しない限り、そのクラスから継承するすべてのコントロールに適用されます。たとえば、XHTML マークアップを表示するデバイスに対して、すべてのモバイル コントロールを検証する場合は、XhtmlValidatorAdapter クラスが使用されます。
処理中、.NET Framework は、コントロールの現在のターゲットに固有のメソッド呼び出しを受け取ります。そのコントロールにコントロール アダプタが関連付けられている場合、.NET Framework は、関連付けられているアダプタのメソッドを呼び出します。
コントロールのいくつかのプロパティでは、モバイル デバイスの複数のセカンダリ ページ (セカンダリ UI) に対する表示方法が制御されます。表示するページを定義するには SecondaryUIMode プロパティを使用します。セカンダリ UI のすべての設定を削除するには、ExitSecondaryUIMode メソッドを使用します。
継承時の注意 XhtmlControlAdapter クラスを継承する場合、MarkupControlTypeAdapter のパターンとして、特定のコントロール タイプとマークアップ言語に対応するアダプタの名前を指定します (例: XhtmlTextBoxAdapter)。XHTML マークアップを提供するコントロールのアダプタは、System.Web.UI.MobileControls.Adapters.XhtmlAdapters 名前空間に実装されます。 .browser 構成ファイルの各デバイス ノード下の専用コントロールに、専用のアダプタを定義する必要があります。 正しく実装されたコントロールでは、アダプタが割り当てられていると見なさない、つまり割り当てられているアダプタが特定のインターフェイスを実装していると見なさないようにする必要があります。代わりに、これらの条件をチェックするようにしてください。 セカンダリ UI のモードのほか、各ブロックの後または各インライン コントロールの後で改行を必要とするディスプレイ デバイスを考慮した条件付きのレンダリング メソッドが複数用意されています。これらの条件付きメソッドの例として、ConditionalSetPendingBreak や ConditionalEnterLayout などが挙げられます。これらのメソッドは、レンダリング対象のコントロールに関係なく、特定のデバイスで機能するように設計されています。通常、このクラスを基に新しいコントロール アダプタを作成する場合、これらのメソッドをオーバーライドする必要はありません。少なくとも、Render メソッドはオーバーライドする必要があります。 サーバー コントロールに対して特定のアダプタを使用するには、デバイス フィルタが必要です。デバイス フィルタの詳細については、「アダプティブ コントロール動作のアーキテクチャの概要」および「ASP.NET デバイスのフィルタ処理の概要」を参照してください。.NET Framework のセキュリティ継承階層
System.Object
System.Web.UI.MobileControls.Adapters.ControlAdapter
System.Web.UI.MobileControls.Adapters.XhtmlAdapters.XhtmlControlAdapter
派生クラス
System.Web.UI.MobileControls.Adapters.ControlAdapter
System.Web.UI.MobileControls.Adapters.XhtmlAdapters.XhtmlControlAdapter
派生クラス
スレッド セーフプラットフォーム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 によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。
バージョン情報参照XhtmlControlAdapter コンストラクタ
メモ : このコンストラクタは、.NET Framework version 2.0 で新しく追加されたものです。 XhtmlControlAdapter クラスの新しいインスタンスを作成します。
名前空間: System.Web.UI.MobileControls.Adapters.XhtmlAdapters
アセンブリ: System.Web.Mobile (system.web.mobile.dll 内)
構文
プラットフォーム
バージョン情報
参照
アセンブリ: System.Web.Mobile (system.web.mobile.dll 内)
構文プラットフォーム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 によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。
バージョン情報参照XhtmlControlAdapter フィールド
.gif)
XhtmlControlAdapter プロパティ
パブリック プロパティ
(
プロテクト プロパティ
も参照)
| 名前 | 説明 | |
|---|---|---|
.gif) | Control | 関連するコントロールへの厳密に型指定された参照を返します。 ( ControlAdapter から継承されます。) |
| | Device | 要求に関連付けられているデバイス機能オブジェクトを返します。 ( ControlAdapter から継承されます。) |
| | ItemWeight | コントロール内の 1 つの項目のおおよそのウェイトにアクセスします。 ( ControlAdapter から継承されます。) |
| | Page | デバイス アダプタに関連付けられたページを返します。 ( ControlAdapter から継承されます。) |
| | Style | デバイス アダプタがアタッチされるコントロールに関連付けられたスタイル オブジェクトを返します。 ( ControlAdapter から継承されます。) |
| | VisibleWeight | コントロールのおおよそのウェイトを文字数で取得または設定します。 ( ControlAdapter から継承されます。) |
プロテクト プロパティ| 名前 | 説明 | |
|---|---|---|
.gif) | CssLocation | スタイル シートの格納場所 (外部の物理ファイル、現在のページ内、現在のセッション状態、アプリケーション キャッシュなど) を示します。 |
| | DocumentType | 現在のドキュメントをレンダリングするために使用する XHTML マークアップのタイプを示します。 |
| | PageAdapter | 関連付けられているコントロールが置かれているページに対応するページ アダプタを取得します。 |
| | SecondaryUIMode | 現在のセカンダリ UI モードを取得します。 |
| | StyleSheetLocationAttributeValue | CssLocation 属性が存在する場合は、その値を親フォームから取得します。 |
| | StyleSheetStorageApplicationSetting | Web.config ファイルの appSettings セクションに存在する XhtmlCssState 構成設定の値を取得します。 |
参照XhtmlControlAdapter メソッド
パブリック メソッド
(
プロテクト メソッド
も参照)
.gif)
プロテクト メソッド| 名前 | 説明 | |
|---|---|---|
.gif) | CalculateOptimumPageWeight | デバイスの最適なページ ウェイトを決定します。 ( ControlAdapter から継承されます。) |
| | ClearPendingBreakIfDeviceBreaksOnBlockLevel | 対象のデバイスがブロック要素で改行する場合に、保留されている改行をクリアします。 |
| | ConditionalClearCachedEndTag | 特定の条件が満たされた場合に、指定されたテキスト ライタの現在の終了タグをクリアします。 |
| | ConditionalClearPendingBreak | 特定の条件が満たされた場合に、対象デバイスの保留されている改行をクリアします。 |
| | ConditionalEnterFormat | 特定の条件が満たされた場合、開始タグ、および、指定されたスタイルの書式を実装する属性でセクションを開始します。 |
| | ConditionalEnterLayout | 特定の条件が満たされた場合、開始タグ、および、指定されたスタイルのレイアウトを実装する属性でセクションを開始します。 |
| | ConditionalEnterStyle | オーバーロードされます。 特定の条件が満たされた場合に、指定されたスタイルを適用する新しい要素を開始します。 |
| | ConditionalExitFormat | 特定の条件が満たされた場合に、指定スタイルの文字書式が使用されたブロックを終了します。 |
| | ConditionalExitLayout | 特定の条件が満たされた場合に、指定スタイルのレイアウト書式が使用されたブロックを終了します。 |
| | ConditionalExitStyle | 特定の条件が満たされた場合に、指定スタイルのレイアウトと文字書式が使用された </span> 要素を終了します。 |
| | ConditionalPopPhysicalCssClass | 特定の条件が満たされた場合に、現在のカスケード スタイル シートのクラス名を System.Web.UI.MobileControls.Adapters.XhtmlAdapters.XhtmlMobileTextWriter オブジェクトから削除します。 |
| | ConditionalRenderClassAttribute | 特定の条件が満たされた場合に、クラス名属性を次にレンダリングする要素に設定します。 |
| | ConditionalRenderClosingDivElement | 特定の条件が満たされた場合に、終了 </div> タグをレンダリングします。 |
| | ConditionalRenderClosingSpanElement | 特定の条件が満たされた場合に、終了 </span> 要素をレンダリングします。 |
| | ConditionalRenderCustomAttribute | オーバーロードされます。 関連付けられたコントロールから指定されたカスタム属性の値を取得し、特定の条件が満たされた場合に、それを次の要素に対してレンダリングします。 |
| | ConditionalRenderOpeningDivElement | 特定の条件が満たされた場合に、<div> の開始タグをレンダリングします。 |
| | ConditionalRenderOpeningSpanElement | 特定の条件が満たされた場合に、<span> の開始タグをレンダリングします。 |
| | ConditionalSetPendingBreak | 特定の条件が満たされた場合に保留改行を設定します。 |
| | ConditionalSetPendingBreakAfterInline | 特定の条件が満たされた場合、インライン要素の後に保留されている改行を設定します。 |
| | ExitSecondaryUIMode | コントロールのセカンダリ UI モードを終了します。 |
| | Finalize | Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 ( Object から継承されます。) |
| | GetCustomAttributeValue | オーバーロードされます。 指定したカスタム属性の値を取得します。 |
| | GetDefaultLabel | ラベル コントロールのローカライズされた既定の文字列を返します。 ( ControlAdapter から継承されます。) |
| | MemberwiseClone | 現在の Object の簡易コピーを作成します。 ( Object から継承されます。) |
| | PreprocessQueryString | 特定のクエリ文字列から、要求を処理するためのパラメータを含む部分を取得します。 |
| | RenderAsHiddenInputField | コントロールの隠しフィールドのテキストをレンダリングします。 |
| | RenderBeginLink | オーバーロードされます。 リンクの開始タグをレンダリングします。 |
| | RenderChildren | コントロールの子をレンダリングします。 ( ControlAdapter から継承されます。) |
| | RenderClosingListTag | 指定されたリスト要素の終了タグをレンダリングします。 |
| | RenderEndLink | リンク要素の終了タグ (</a>) をレンダリングします。 |
| | RenderOffPageVariables | 改ページ位置の自動修正またはセカンダリ UI などの理由で表示されない子コントロールの非表示のポストバック変数をレンダリングします。 |
| | RenderOpeningListTag | 指定されたタグ名の開始タグをレンダリングします。 |
| | RenderPostBackEventAsAnchor | オーバーロードされます。 ポストバック イベントをページ上のリンクとしてレンダリングします。 |
参照XhtmlControlAdapter メンバ
モバイル コントロールを XHTML マークアップでレンダリングするための既定のコントロール アダプタを提供します。
XhtmlControlAdapter データ型で公開されるメンバを以下の表に示します。
パブリック コンストラクタプロテクト フィールドパブリック プロパティ
(
プロテクト プロパティ
も参照)
| 名前 | 説明 | |
|---|---|---|
| | Control | 関連するコントロールへの厳密に型指定された参照を返します。(ControlAdapter から継承されます。) |
| | Device | 要求に関連付けられているデバイス機能オブジェクトを返します。(ControlAdapter から継承されます。) |
| | ItemWeight | コントロール内の 1 つの項目のおおよそのウェイトにアクセスします。(ControlAdapter から継承されます。) |
| | Page | デバイス アダプタに関連付けられたページを返します。(ControlAdapter から継承されます。) |
| | Style | デバイス アダプタがアタッチされるコントロールに関連付けられたスタイル オブジェクトを返します。(ControlAdapter から継承されます。) |
| | VisibleWeight | コントロールのおおよそのウェイトを文字数で取得または設定します。(ControlAdapter から継承されます。) |
プロテクト プロパティ| 名前 | 説明 | |
|---|---|---|
| | CssLocation | スタイル シートの格納場所 (外部の物理ファイル、現在のページ内、現在のセッション状態、アプリケーション キャッシュなど) を示します。 |
| | DocumentType | 現在のドキュメントをレンダリングするために使用する XHTML マークアップのタイプを示します。 |
| | PageAdapter | 関連付けられているコントロールが置かれているページに対応するページ アダプタを取得します。 |
| | SecondaryUIMode | 現在のセカンダリ UI モードを取得します。 |
| | StyleSheetLocationAttributeValue | CssLocation 属性が存在する場合は、その値を親フォームから取得します。 |
| | StyleSheetStorageApplicationSetting | Web.config ファイルの appSettings セクションに存在する XhtmlCssState 構成設定の値を取得します。 |
パブリック メソッド
(
プロテクト メソッド
も参照)
プロテクト メソッド| 名前 | 説明 | |
|---|---|---|
| | CalculateOptimumPageWeight | デバイスの最適なページ ウェイトを決定します。 (ControlAdapter から継承されます。) |
| | ClearPendingBreakIfDeviceBreaksOnBlockLevel | 対象のデバイスがブロック要素で改行する場合に、保留されている改行をクリアします。 |
| | ConditionalClearCachedEndTag | 特定の条件が満たされた場合に、指定されたテキスト ライタの現在の終了タグをクリアします。 |
| | ConditionalClearPendingBreak | 特定の条件が満たされた場合に、対象デバイスの保留されている改行をクリアします。 |
| | ConditionalEnterFormat | 特定の条件が満たされた場合、開始タグ、および、指定されたスタイルの書式を実装する属性でセクションを開始します。 |
| | ConditionalEnterLayout | 特定の条件が満たされた場合、開始タグ、および、指定されたスタイルのレイアウトを実装する属性でセクションを開始します。 |
| | ConditionalEnterStyle | オーバーロードされます。 特定の条件が満たされた場合に、指定されたスタイルを適用する新しい要素を開始します。 |
| | ConditionalExitFormat | 特定の条件が満たされた場合に、指定スタイルの文字書式が使用されたブロックを終了します。 |
| | ConditionalExitLayout | 特定の条件が満たされた場合に、指定スタイルのレイアウト書式が使用されたブロックを終了します。 |
| | ConditionalExitStyle | 特定の条件が満たされた場合に、指定スタイルのレイアウトと文字書式が使用された </span> 要素を終了します。 |
| | ConditionalPopPhysicalCssClass | 特定の条件が満たされた場合に、現在のカスケード スタイル シートのクラス名を System.Web.UI.MobileControls.Adapters.XhtmlAdapters.XhtmlMobileTextWriter オブジェクトから削除します。 |
| | ConditionalRenderClassAttribute | 特定の条件が満たされた場合に、クラス名属性を次にレンダリングする要素に設定します。 |
| | ConditionalRenderClosingDivElement | 特定の条件が満たされた場合に、終了 </div> タグをレンダリングします。 |
| | ConditionalRenderClosingSpanElement | 特定の条件が満たされた場合に、終了 </span> 要素をレンダリングします。 |
| | ConditionalRenderCustomAttribute | オーバーロードされます。 関連付けられたコントロールから指定されたカスタム属性の値を取得し、特定の条件が満たされた場合に、それを次の要素に対してレンダリングします。 |
| | ConditionalRenderOpeningDivElement | 特定の条件が満たされた場合に、<div> の開始タグをレンダリングします。 |
| | ConditionalRenderOpeningSpanElement | 特定の条件が満たされた場合に、<span> の開始タグをレンダリングします。 |
| | ConditionalSetPendingBreak | 特定の条件が満たされた場合に保留改行を設定します。 |
| | ConditionalSetPendingBreakAfterInline | 特定の条件が満たされた場合、インライン要素の後に保留されている改行を設定します。 |
| | ExitSecondaryUIMode | コントロールのセカンダリ UI モードを終了します。 |
| | Finalize | Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 (Object から継承されます。) |
| | GetCustomAttributeValue | オーバーロードされます。 指定したカスタム属性の値を取得します。 |
| | GetDefaultLabel | ラベル コントロールのローカライズされた既定の文字列を返します。 (ControlAdapter から継承されます。) |
| | MemberwiseClone | 現在の Object の簡易コピーを作成します。 (Object から継承されます。) |
| | PreprocessQueryString | 特定のクエリ文字列から、要求を処理するためのパラメータを含む部分を取得します。 |
| | RenderAsHiddenInputField | コントロールの隠しフィールドのテキストをレンダリングします。 |
| | RenderBeginLink | オーバーロードされます。 リンクの開始タグをレンダリングします。 |
| | RenderChildren | コントロールの子をレンダリングします。 (ControlAdapter から継承されます。) |
| | RenderClosingListTag | 指定されたリスト要素の終了タグをレンダリングします。 |
| | RenderEndLink | リンク要素の終了タグ (</a>) をレンダリングします。 |
| | RenderOffPageVariables | 改ページ位置の自動修正またはセカンダリ UI などの理由で表示されない子コントロールの非表示のポストバック変数をレンダリングします。 |
| | RenderOpeningListTag | 指定されたタグ名の開始タグをレンダリングします。 |
| | RenderPostBackEventAsAnchor | オーバーロードされます。 ポストバック イベントをページ上のリンクとしてレンダリングします。 |
参照- XhtmlControlAdapterのページへのリンク
