更新:2007 年 11 月
HTML 适配器集在能够呈现支持脚本撰写的 HTML 3.2 的客户端(例如用于 Pocket PC 的 Microsoft Internet Explorer)上呈现 ASP.NET 移动网页。
下表列出了 HTML 适配器集中包括的核心类。
适配器集 |
核心适配器类命名空间 |
|---|---|
ControlAdapter 抽象基类 |
|
PageAdapter 抽象类 |
|
选项
如果 MobileCapabilities 类的 PreferredRenderingType 属性返回 PreferredRenderingTypeHtml32 并且浏览器功能类的 JavaScript 属性返回 true,则选择 HTML 适配器集。
默认呈现
以下描述 HTML 适配器集中页和窗体适配器类的默认呈现。
页适配器执行以下步骤:
对编写器调用 BeginResponse 和 BeginFile 方法。内容类型为 text/html。
写出一个开始 <html> 标记。
呈现活动窗体。
写出一个结束 </html> 标记。
调用 EndFile 和 EndResponse 方法。
窗体适配器执行以下步骤:
如果需要一个 <title> 元素,则写出此元素。
写出 <body> 和 <form> 标记。
写出隐藏的和内部窗体变量并回发脚本。
呈现窗体内容。
写出结束 </form> 和 </body> 标记。
使用样式
HtmlMobileTextWriter 类提供了若干帮助器方法,有助于使用样式信息来控制字符和布局外观:
EnterFormat 和 ExitFormat 方法分隔字符格式设置块。
EnterLayout 和 ExitLayout 方法分隔对齐方式和换行布局块。
EnterStyle 和 ExitStyle 方法分隔字符格式设置以及对齐方式和换行布局块。
若干属性控制写入哪些样式属性。这些属性(例如 RenderBold、RenderItalic 等)是在创建编写器时使用请求设备的设备功能设置的。
ExitLayout(Style, Boolean)、ExitFormat(Style, Boolean) 和 ExitStyle(Style, Boolean) 方法的 breakAfter 参数控制是否在格式和布局标记后插入换行符。如果此参数设置为 true,则使用 <br> 或 <div> 元素在输出中显示逻辑换行符。
呈现回发内容
窗体回发呈现为对与该窗体一起写出的客户端脚本的调用。
若要将回发事件呈现为适配器的定位点,您可以调用 HtmlControlAdapter 基类的 RenderPostBackEventAsAnchor 方法。此方法写出 <a> 标记并在用户单击链接时生成回发。
若要将回发事件呈现为控件适配器的另一个标记的属性,则可以调用 RenderPostBackEventAsAttribute 方法。您可以使用此方法作为其他标记的一部分;例如,可使用此方法为按钮创建 onClick 属性。
呈现链接
指向其他页的链接呈现为超链接。指向同一页上其他窗体的链接呈现为窗体回发。
若要为移动控件适配器呈现链接,可以调用 HtmlControlAdapter 基类的 RenderBeginLink 和 RenderEndLink 方法。RenderBeginLink 方法自动检查链接类型,并呈现相应的标记。
辅助用户界面
HTML 适配器集支持称作“辅助用户界面”的概念。辅助用户界面由显示用户界面的附加屏幕的控件使用。若要使用辅助用户界面,控件适配器要执行以下步骤:
在响应某些用户交互(通常在可重写的 HandlePostBackEvent 方法中)时,控件适配器通过设置 HtmlControlAdapter 基类的 SecondaryUIMode 属性,指定辅助用户界面模式。
在呈现时,控件检查它是否处于辅助用户界面模式;如果是,则呈现适当的辅助用户界面。
在响应辅助用户界面中的用户交互时,控件适配器可能会将辅助用户界面模式更改为其他值,或者通过调用 HtmlControlAdapter 基类的 ExitSecondaryUIMode 方法退出辅助用户界面模式。