HTML 适配器集

更新:2007 年 11 月

HTML 适配器集在能够呈现支持脚本撰写的 HTML 3.2 的客户端(例如用于 Pocket PC 的 Microsoft Internet Explorer)上呈现 ASP.NET 移动网页。

下表列出了 HTML 适配器集中包括的核心类。

适配器集

核心适配器类命名空间

ControlAdapter 抽象基类

HtmlControlAdapter

HtmlControlAdapter

HtmlFormAdapter

PageAdapter 抽象类

HtmlControlAdapter

MobileTextWriter

HtmlMobileTextWriter

选项

如果 MobileCapabilities 类的 PreferredRenderingType 属性返回 PreferredRenderingTypeHtml32 并且浏览器功能类的 JavaScript 属性返回 true,则选择 HTML 适配器集。

默认呈现

以下描述 HTML 适配器集中页和窗体适配器类的默认呈现。

页适配器执行以下步骤:

  1. 对编写器调用 BeginResponseBeginFile 方法。内容类型为 text/html。

  2. 写出一个开始 <html> 标记。

  3. 呈现活动窗体。

  4. 写出一个结束 </html> 标记。

  5. 调用 EndFileEndResponse 方法。

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

  1. 如果需要一个 <title> 元素,则写出此元素。

  2. 写出 <body> 和 <form> 标记。

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

  4. 呈现窗体内容。

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

使用样式

HtmlMobileTextWriter 类提供了若干帮助器方法,有助于使用样式信息来控制字符和布局外观:

若干属性控制写入哪些样式属性。这些属性(例如 RenderBoldRenderItalic 等)是在创建编写器时使用请求设备的设备功能设置的。

ExitLayout(Style, Boolean)ExitFormat(Style, Boolean)ExitStyle(Style, Boolean) 方法的 breakAfter 参数控制是否在格式和布局标记后插入换行符。如果此参数设置为 true,则使用 <br> 或 <div> 元素在输出中显示逻辑换行符。

呈现回发内容

窗体回发呈现为对与该窗体一起写出的客户端脚本的调用。

若要将回发事件呈现为适配器的定位点,您可以调用 HtmlControlAdapter 基类的 RenderPostBackEventAsAnchor 方法。此方法写出 <a> 标记并在用户单击链接时生成回发。

若要将回发事件呈现为控件适配器的另一个标记的属性,则可以调用 RenderPostBackEventAsAttribute 方法。您可以使用此方法作为其他标记的一部分;例如,可使用此方法为按钮创建 onClick 属性。

呈现链接

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

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

辅助用户界面

HTML 适配器集支持称作“辅助用户界面”的概念。辅助用户界面由显示用户界面的附加屏幕的控件使用。若要使用辅助用户界面,控件适配器要执行以下步骤:

  1. 在响应某些用户交互(通常在可重写的 HandlePostBackEvent 方法中)时,控件适配器通过设置 HtmlControlAdapter 基类的 SecondaryUIMode 属性,指定辅助用户界面模式。

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

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

请参见

概念

适配器集功能