通过

XHTML 适配器集

更新：2007 年 11 月

XHTML 适配器集在能够呈现 XHTML Basic 和 XHTML 的客户端（例如用于 Pocket PC 的 Microsoft Internet Explorer）上呈现 ASP.NET 移动网页。

下表列出了适配器集类、返回类的属性和包括在 XHTML 适配器集中的核心类。

适配器集类或属性

核心适配器类

ControlAdapter（基类）

XhtmlControlAdapter

FormAdapter

XhtmlFormAdapter

PageAdapter

XhtmlPageAdapter

MobileTextWriter

XhtmlMobileTextWriter

选择

如果首选呈现类型为“xhtml-basic”、“xhtml-mp”或“wml20”，则选择 XHTML 适配器集。

说明：

在 ASP.NET 2.0 中，XHTML 可能的首选呈现类型不是 MobileCapabilities 类的一部分。

默认呈现

在 XHTML 适配器集中的页和窗体适配器类的默认呈现过程中，页适配器执行下列步骤。

  1. 调用编写器的 BeginResponse 和 BeginFile 方法。内容类型设置为“text/html”。

  2. 编写 XML 声明 (<? xml version=1.0 encoding="encodingType" ?>)。

  3. 编写 XHTML 文档 DTD 引用。

  4. 编写一个开始 <html xmlns="http://www.w3.org/1999/xhtml" > 标记。

  5. 呈现活动窗体。

  6. 编写一个结束 </html> 标记。

  7. 调用 EndFile 和 EndResponse 方法。

窗体适配器执行以下步骤：

  1. 如果需要一个开始 title 元素，则编写此元素。

  2. 编写开始 <body> 和 <form> 标记。

  3. 编写任何隐藏的和内部窗体变量并编写回发脚本。

  4. 呈现窗体内容。

  5. 编写结束 </form> 和 </body> 标记。

使用样式

XhtmlMobileTextWriter 类提供了下列帮助器方法，有助于使用样式信息来控制字符或布局外观的某些方面：

若干属性确定写入哪些样式属性。这些属性（例如 RenderBold、RenderItalic 等）是在创建编写器时使用所请求设备的设备功能设置的。

ExitLayout、ExitFormat 和 ExitStyle 方法的 breakAfter 参数控制是否在格式和布局标记后插入换行符。如果 breakAfter 参数设置为 true，则使用 br 或 div 元素在输出中呈现逻辑换行符。

呈现回发控件

默认情况下，窗体回发控件呈现为按钮。若要将链接用作回发控件，可以调用 XhtmlControlAdapter 基类的 RenderPostBackEventAsAnchor 方法。此方法呈现一个 a 元素，在用户单击该链接时此元素回发窗体。

您也可通过为控件适配器设置其他元素的属性来创建回发控件。为此，可以调用 RenderPostBackEventAsAttribute 方法。例如，可以使用该方法为按钮创建 onClick 属性。

呈现链接

指向其他页的链接呈现为超链接。指向同一页上其他窗体的链接呈现为回发控件。

若要为移动控件适配器呈现链接，可以调用 XhtmlControlAdapter 基类的 RenderBeginLink 和 RenderEndLink 方法。RenderBeginLink 方法自动检查链接类型，并呈现相应的标记。

辅助用户界面

XHTML 适配器集支持辅助用户界面，控件使用该界面来显示用户界面的附加屏幕。若要使用辅助用户界面，控件适配器要执行以下步骤：

  1. 在响应某些用户交互（通常在可重写的 HandlePostBackEvent 方法中）时，控件适配器通过将 XhtmlControlAdapter 基类的 SecondaryUIMode 属性设置为内部已知常数，指定辅助用户界面模式。

  2. 在呈现时，控件检查它是否处于辅助用户界面模式；如果是，则呈现适当的辅助用户界面。

  3. 在响应辅助用户界面中的用户交互时，控件适配器可能会将辅助用户界面模式更改为其他值，或者通过调用 XhtmlControlAdapter 基类的 ExitSecondaryUIMode 方法退出辅助用户界面模式。

请参见

概念

适配器集功能