XhtmlControlAdapter 类

参考

定义

命名空间:: System.Web.UI.MobileControls.Adapters.XhtmlAdapters

程序集:: System.Web.Mobile.dll

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

注意

The System.Web.Mobile.dll assembly has been deprecated and should no longer be used. For information about how to develop ASP.NET mobile applications, see http://go.microsoft.com/fwlink/?LinkId=157231.

提供一个用于在 XHTML 标记中呈现移动控件的默认控件适配器。有关如何开发 ASP.NET 移动应用程序的信息，请参阅移动应用 & 具有 ASP.NET 的网站。

public ref class XhtmlControlAdapter : System::Web::UI::MobileControls::Adapters::ControlAdapter

public class XhtmlControlAdapter : System.Web.UI.MobileControls.Adapters.ControlAdapter

[System.Obsolete("The System.Web.Mobile.dll assembly has been deprecated and should no longer be used. For information about how to develop ASP.NET mobile applications, see http://go.microsoft.com/fwlink/?LinkId=157231.")]
public class XhtmlControlAdapter : System.Web.UI.MobileControls.Adapters.ControlAdapter

type XhtmlControlAdapter = class
    inherit ControlAdapter

[<System.Obsolete("The System.Web.Mobile.dll assembly has been deprecated and should no longer be used. For information about how to develop ASP.NET mobile applications, see http://go.microsoft.com/fwlink/?LinkId=157231.")>]
type XhtmlControlAdapter = class
    inherit ControlAdapter

Public Class XhtmlControlAdapter
Inherits ControlAdapter

继承: Object

ControlAdapter
XhtmlControlAdapter

派生: System.Web.UI.MobileControls.Adapters.XhtmlAdapters.XhtmlCalendarAdapter

System.Web.UI.MobileControls.Adapters.XhtmlAdapters.XhtmlCommandAdapter

System.Web.UI.MobileControls.Adapters.XhtmlAdapters.XhtmlFormAdapter

System.Web.UI.MobileControls.Adapters.XhtmlAdapters.XhtmlImageAdapter

System.Web.UI.MobileControls.Adapters.XhtmlAdapters.XhtmlLabelAdapter

更多…

属性: ObsoleteAttribute

注解

此类提供基本移动控件适配器，该适配器在移动设备的 XHTML 标记中呈现控件及其每个子控件。它还为派生的 XHTML 移动控件适配器提供帮助程序方法和通用属性。

控件适配器是替代某些 Control 类方法和事件以允许浏览器特定或特定于标记的处理的组件。呈现行为的很多适应性都封装在类中 XhtmlTextWriter 。如果你在考虑是否生成自己的控件适配器，请记住，单个适配器可用于替代许多浏览器类行为。或者，通过在派生自 XhtmlMobileTextWriter 类的类中包含所需的适应性，可以消除使用控件适配器的需要。

特定控件类的适配器适用于从该类继承的所有控件，除非存在更专用的适配器。例如， XhtmlValidatorAdapter 类用于验证需要或可以显示 XHTML 标记的设备的所有移动控件。

在处理期间，.NET Framework截获对特定于当前目标的控件方法的调用。如果控件适配器与控件相关联，.NET Framework调用关联的适配器方法。

控件的某些属性控制它在移动设备的多个辅助页中的显示方式。这些页面统称为 辅助 UI。属性 SecondaryUIMode 可用于定义将显示哪个页面。方法 ExitSecondaryUIMode 可用于删除任何辅助 UI 设置。

继承者说明

从 XhtmlControlAdapter 类继承时，为给定控件类型和标记语言 MarkupControlTypeAdapter 命名适配器， (例如 XhtmlTextBoxAdapter ，) 。应在命名空间中实现提供 XHTML 标记的控件的 System.Web.UI.MobileControls.Adapters.XhtmlAdapters 适配器。

应为配置 .browser 文件中每个设备节点下的专用控件定义任何专用适配器。

正确实现的控件不应假定适配器已附加，或者附加的适配器实现了特定的接口。相反，它应针对这些条件检查。

许多条件呈现方法允许使用辅助 UI 等条件，以及在每个块之后或每个内联控件之后需要换行符的显示设备。这些条件方法的示例包括 ConditionalSetPendingBreak(XhtmlMobileTextWriter) 和 ConditionalEnterLayout(XhtmlMobileTextWriter, Style)。无论呈现的控件如何，这些方法都适用于给定设备。创建基于此类的新控件适配器时，不太可能需要重写这些方法。至少需要重写 Render 方法。

需要对服务器控件使用特定适配器进行设备筛选。有关设备筛选的详细信息，请参阅自适应控制行为的体系结构概述和设备筛选概述。

构造函数

XhtmlControlAdapter()

已过时.

创建 XhtmlControlAdapter 类的新实例。此 API 已废弃不用。有关如何开发 ASP.NET 移动应用程序的信息，请参阅移动应用 & 具有 ASP.NET 的网站。

字段

NotSecondaryUI

已过时.

一个由 SecondaryUIMode 属性返回的值，它指示适配器当前未处于辅助用户界面模式中。此 API 已废弃不用。有关如何开发 ASP.NET 移动应用程序的信息，请参阅移动应用 & 具有 ASP.NET 的网站。

属性

Control	已过时. 返回一个对关联控件的强类型引用。此 API 已废弃不用。有关如何开发 ASP.NET 移动应用程序的信息，请参阅移动应用 & 具有 ASP.NET 的网站。 (继承自 ControlAdapter)
CssLocation	已过时. 指示样式表是作为外部物理文件定位、位于当前页内部、存储在当前会话状态中，还是存储在应用程序缓存中。此 API 已废弃不用。有关如何开发 ASP.NET 移动应用程序的信息，请参阅移动应用 & 具有 ASP.NET 的网站。
Device	已过时. 返回与请求关联的设备功能对象。此 API 已废弃不用。有关如何开发 ASP.NET 移动应用程序的信息，请参阅移动应用 & 具有 ASP.NET 的网站。 (继承自 ControlAdapter)
DocumentType	已过时. 指示用于呈现当前文档的 XHTML 标记的类型。此 API 已废弃不用。有关如何开发 ASP.NET 移动应用程序的信息，请参阅移动应用 & 具有 ASP.NET 的网站。
ItemWeight	已过时. 访问控件中某一项的大致权重。此 API 已废弃不用。有关如何开发 ASP.NET 移动应用程序的信息，请参阅移动应用 & 具有 ASP.NET 的网站。 (继承自 ControlAdapter)
Page	已过时. 返回与设备适配器关联的页。此 API 已废弃不用。有关如何开发 ASP.NET 移动应用程序的信息，请参阅移动应用 & 具有 ASP.NET 的网站。 (继承自 ControlAdapter)
PageAdapter	已过时. 获取关联控件所在页的页适配器。此 API 已废弃不用。有关如何开发 ASP.NET 移动应用程序的信息，请参阅移动应用 & 具有 ASP.NET 的网站。
SecondaryUIMode	已过时. 获取当前辅助用户界面模式。此 API 已废弃不用。有关如何开发 ASP.NET 移动应用程序的信息，请参阅移动应用 & 具有 ASP.NET 的网站。
Style	已过时. 返回与设备适配器附加到的控件关联的样式对象。此 API 已废弃不用。有关如何开发 ASP.NET 移动应用程序的信息，请参阅移动应用 & 具有 ASP.NET 的网站。 (继承自 ControlAdapter)
StyleSheetLocationAttributeValue	已过时. 如果 `CssLocation` 特性存在，则从该特性所在的窗体获取其值。此 API 已废弃不用。有关如何开发 ASP.NET 移动应用程序的信息，请参阅移动应用 & 具有 ASP.NET 的网站。
StyleSheetStorageApplicationSetting	已过时. 获取 Web.config 文件中 `XhtmlCssState` 的节中的 `appSettings` 的配置设置的值。此 API 已废弃不用。有关如何开发 ASP.NET 移动应用程序的信息，请参阅移动应用 & 具有 ASP.NET 的网站。
VisibleWeight	已过时. 获取或设置该控件的大致权重（以字符为单位）。此 API 已废弃不用。有关如何开发 ASP.NET 移动应用程序的信息，请参阅移动应用 & 具有 ASP.NET 的网站。 (继承自 ControlAdapter)

方法

CalculateOptimumPageWeight(Int32)	已过时. 确定设备的最佳页权重。此 API 已废弃不用。有关如何开发 ASP.NET 移动应用程序的信息，请参阅移动应用 & 具有 ASP.NET 的网站。 (继承自 ControlAdapter)
ClearPendingBreakIfDeviceBreaksOnBlockLevel(XhtmlMobileTextWriter)	已过时. 如果目标设备在块元素上分行，则清除挂起的分行符。此 API 已废弃不用。有关如何开发 ASP.NET 移动应用程序的信息，请参阅移动应用 & 具有 ASP.NET 的网站。
ConditionalClearCachedEndTag(XhtmlMobileTextWriter, String)	已过时. 满足某些条件时清除给定文本编写器的当前结束标记。此 API 已废弃不用。有关如何开发 ASP.NET 移动应用程序的信息，请参阅移动应用 & 具有 ASP.NET 的网站。
ConditionalClearPendingBreak(XhtmlMobileTextWriter)	已过时. 满足某些条件时清除目标设备中的挂起分行符。此 API 已废弃不用。有关如何开发 ASP.NET 移动应用程序的信息，请参阅移动应用 & 具有 ASP.NET 的网站。
ConditionalEnterFormat(XhtmlMobileTextWriter, Style)	已过时. 满足某些条件时用开始标记和实现指定样式的格式的属性来开始一节。此 API 已废弃不用。有关如何开发 ASP.NET 移动应用程序的信息，请参阅移动应用 & 具有 ASP.NET 的网站。
ConditionalEnterLayout(XhtmlMobileTextWriter, Style)	已过时. 满足某些条件时用开始标记和实现指定样式的布局的属性来开始一节。此 API 已废弃不用。有关如何开发 ASP.NET 移动应用程序的信息，请参阅移动应用 & 具有 ASP.NET 的网站。
ConditionalEnterStyle(XhtmlMobileTextWriter, Style)	已过时. 满足某些条件时编写 `<span>` 一节的开始标记以及实现指定样式的布局和字符格式的属性。此 API 已废弃不用。有关如何开发 ASP.NET 移动应用程序的信息，请参阅移动应用 & 具有 ASP.NET 的网站。
ConditionalEnterStyle(XhtmlMobileTextWriter, Style, String)	已过时. 满足某些条件时编写指定元素的开始标记以及实现指定样式的布局和字符格式的属性。此 API 已废弃不用。有关如何开发 ASP.NET 移动应用程序的信息，请参阅移动应用 & 具有 ASP.NET 的网站。
ConditionalExitFormat(XhtmlMobileTextWriter, Style)	已过时. 满足某些条件时结束使用过指定样式的字符格式的块。此 API 已废弃不用。有关如何开发 ASP.NET 移动应用程序的信息，请参阅移动应用 & 具有 ASP.NET 的网站。
ConditionalExitLayout(XhtmlMobileTextWriter, Style)	已过时. 满足某些条件时结束使用过指定样式的布局格式的块。此 API 已废弃不用。有关如何开发 ASP.NET 移动应用程序的信息，请参阅移动应用 & 具有 ASP.NET 的网站。
ConditionalExitStyle(XhtmlMobileTextWriter, Style)	已过时. 满足某些条件时结束使用过指定样式的布局和字符格式的 `</span>` 元素。此 API 已废弃不用。有关如何开发 ASP.NET 移动应用程序的信息，请参阅移动应用 & 具有 ASP.NET 的网站。
ConditionalPopPhysicalCssClass(XhtmlMobileTextWriter)	已过时. 如果满足某些条件，则从 XhtmlMobileTextWriter 对象删除当前的级联样式表类名称。此 API 已废弃不用。有关如何开发 ASP.NET 移动应用程序的信息，请参阅移动应用 & 具有 ASP.NET 的网站。
ConditionalRenderClassAttribute(XhtmlMobileTextWriter)	已过时. 满足某些条件时将一个类名称属性放置在要呈现的下一个元素上。此 API 已废弃不用。有关如何开发 ASP.NET 移动应用程序的信息，请参阅移动应用 & 具有 ASP.NET 的网站。
ConditionalRenderClosingDivElement(XhtmlMobileTextWriter)	已过时. 满足某些条件时呈现 `</div>` 结束标记。此 API 已废弃不用。有关如何开发 ASP.NET 移动应用程序的信息，请参阅移动应用 & 具有 ASP.NET 的网站。
ConditionalRenderClosingSpanElement(XhtmlMobileTextWriter)	已过时. 满足某些条件时呈现 `</span>` 结束元素。此 API 已废弃不用。有关如何开发 ASP.NET 移动应用程序的信息，请参阅移动应用 & 具有 ASP.NET 的网站。
ConditionalRenderCustomAttribute(XhtmlMobileTextWriter, String)	已过时. 满足某些条件时，从关联控件获取具有指定名称的特性的值，并将其呈现在具有指定名称的下一个元素上。此 API 已废弃不用。有关如何开发 ASP.NET 移动应用程序的信息，请参阅移动应用 & 具有 ASP.NET 的网站。
ConditionalRenderCustomAttribute(XhtmlMobileTextWriter, String, String)	已过时. 满足某些条件时，在要呈现的下一个元素中包含具有指定名称和值的自定义属性。此 API 已废弃不用。有关如何开发 ASP.NET 移动应用程序的信息，请参阅移动应用 & 具有 ASP.NET 的网站。
ConditionalRenderOpeningDivElement(XhtmlMobileTextWriter)	已过时. 满足某些条件时呈现 `<div>` 元素的开始标记。此 API 已废弃不用。有关如何开发 ASP.NET 移动应用程序的信息，请参阅移动应用 & 具有 ASP.NET 的网站。
ConditionalRenderOpeningSpanElement(XhtmlMobileTextWriter)	已过时. 满足某些条件时呈现 `<span>` 元素的开始标记。此 API 已废弃不用。有关如何开发 ASP.NET 移动应用程序的信息，请参阅移动应用 & 具有 ASP.NET 的网站。
ConditionalSetPendingBreak(XhtmlMobileTextWriter)	已过时. 满足某些条件时设置挂起的分行符。此 API 已废弃不用。有关如何开发 ASP.NET 移动应用程序的信息，请参阅移动应用 & 具有 ASP.NET 的网站。
ConditionalSetPendingBreakAfterInline(XhtmlMobileTextWriter)	已过时. 满足某些条件时在内联元素后设置挂起的分行符。此 API 已废弃不用。有关如何开发 ASP.NET 移动应用程序的信息，请参阅移动应用 & 具有 ASP.NET 的网站。
CreateTemplatedUI(Boolean)	已过时. 由控件调用以创建模板化用户界面 (UI)。此 API 已废弃不用。有关如何开发 ASP.NET 移动应用程序的信息，请参阅移动应用 & 具有 ASP.NET 的网站。 (继承自 ControlAdapter)
Equals(Object)	已过时. 确定指定对象是否等于当前对象。 (继承自 Object)
ExitSecondaryUIMode()	已过时. 退出控件的所有辅助用户界面模式。此 API 已废弃不用。有关如何开发 ASP.NET 移动应用程序的信息，请参阅移动应用 & 具有 ASP.NET 的网站。
GetCustomAttributeValue(MobileControl, String)	已过时. 从给定控件中获取指定特性的值。此 API 已废弃不用。有关如何开发 ASP.NET 移动应用程序的信息，请参阅移动应用 & 具有 ASP.NET 的网站。
GetCustomAttributeValue(String)	已过时. 从关联控件的标记中获取指定特性的值。此 API 已废弃不用。有关如何开发 ASP.NET 移动应用程序的信息，请参阅移动应用 & 具有 ASP.NET 的网站。
GetDefaultLabel(Int32)	已过时. 返回标签控件的本地化默认字符串。此 API 已废弃不用。有关如何开发 ASP.NET 移动应用程序的信息，请参阅移动应用 & 具有 ASP.NET 的网站。 (继承自 ControlAdapter)
GetHashCode()	已过时. 作为默认哈希函数。 (继承自 Object)
GetType()	已过时. 获取当前实例的 Type。 (继承自 Object)
HandlePostBackEvent(String)	已过时. 如果已处理事件，则返回 `true`。此 API 已废弃不用。有关如何开发 ASP.NET 移动应用程序的信息，请参阅移动应用 & 具有 ASP.NET 的网站。 (继承自 ControlAdapter)
LoadAdapterState(Object)	已过时. 加载特定于此适配器的视图状态数据。此 API 已废弃不用。有关如何开发 ASP.NET 移动应用程序的信息，请参阅移动应用 & 具有 ASP.NET 的网站。
LoadPostData(String, NameValueCollection, Object, Boolean)	已过时. 如果适配器处理 post 数据的加载，则返回 `true`。此 API 已废弃不用。有关如何开发 ASP.NET 移动应用程序的信息，请参阅移动应用 & 具有 ASP.NET 的网站。 (继承自 ControlAdapter)
MemberwiseClone()	已过时. 创建当前 Object 的浅表副本。 (继承自 Object)
OnInit(EventArgs)	已过时. 在初始化窗体或页面等对象后调用。此 API 已废弃不用。有关如何开发 ASP.NET 移动应用程序的信息，请参阅移动应用 & 具有 ASP.NET 的网站。 (继承自 ControlAdapter)
OnLoad(EventArgs)	已过时. 加载与控件、页面或设备适配器相关的数据。此 API 已废弃不用。有关如何开发 ASP.NET 移动应用程序的信息，请参阅移动应用 & 具有 ASP.NET 的网站。 (继承自 ControlAdapter)
OnPreRender(EventArgs)	已过时. 由控件的 OnPreRender(EventArgs) 方法调用，以在呈现前执行适配器特定的工作。此 API 已废弃不用。有关如何开发 ASP.NET 移动应用程序的信息，请参阅移动应用 & 具有 ASP.NET 的网站。 (继承自 ControlAdapter)
OnUnload(EventArgs)	已过时. 卸载与控件、页或设备适配器有关的数据。此 API 已废弃不用。有关如何开发 ASP.NET 移动应用程序的信息，请参阅移动应用 & 具有 ASP.NET 的网站。 (继承自 ControlAdapter)
PreprocessQueryString(String)	已过时. 获取给定查询字符串中包含用于处理请求的参数的部分。此 API 已废弃不用。有关如何开发 ASP.NET 移动应用程序的信息，请参阅移动应用 & 具有 ASP.NET 的网站。
Render(HtmlTextWriter)	已过时. 在客户端上显示关联控件及其所有子控件。此 API 已废弃不用。有关如何开发 ASP.NET 移动应用程序的信息，请参阅移动应用 & 具有 ASP.NET 的网站。
Render(XhtmlMobileTextWriter)	已过时. 在客户端上显示关联控件及其所有子控件。此 API 已废弃不用。有关如何开发 ASP.NET 移动应用程序的信息，请参阅移动应用 & 具有 ASP.NET 的网站。
RenderAsHiddenInputField(XhtmlMobileTextWriter)	已过时. 呈现控件的隐藏字段的文本。此 API 已废弃不用。有关如何开发 ASP.NET 移动应用程序的信息，请参阅移动应用 & 具有 ASP.NET 的网站。
RenderBeginLink(XhtmlMobileTextWriter, String)	已过时. 使用给定 XhtmlMobileTextWriter 和目标呈现链接的开始标记。此 API 已废弃不用。有关如何开发 ASP.NET 移动应用程序的信息，请参阅移动应用 & 具有 ASP.NET 的网站。
RenderBeginLink(XhtmlMobileTextWriter, String, String, Style, String)	已过时. 使用给定 XhtmlMobileTextWriter 和目标以及给定样式或给定级联样式表类名称来呈现链接的开始标记。此 API 已废弃不用。有关如何开发 ASP.NET 移动应用程序的信息，请参阅移动应用 & 具有 ASP.NET 的网站。
RenderBeginLink(XhtmlMobileTextWriter, String, String, Style, String, String)	已过时. 使用给定 XhtmlMobileTextWriter 和目标，并使用给定样式或给定级联样式表类名称、访问键和标题文本来呈现链接的开始标记。此 API 已废弃不用。有关如何开发 ASP.NET 移动应用程序的信息，请参阅移动应用 & 具有 ASP.NET 的网站。
RenderChildren(HtmlTextWriter)	已过时. 呈现控件的子级。此 API 已废弃不用。有关如何开发 ASP.NET 移动应用程序的信息，请参阅移动应用 & 具有 ASP.NET 的网站。 (继承自 ControlAdapter)
RenderClosingListTag(XhtmlMobileTextWriter, String)	已过时. 呈现指定列表元素的结束标记。此 API 已废弃不用。有关如何开发 ASP.NET 移动应用程序的信息，请参阅移动应用 & 具有 ASP.NET 的网站。
RenderEndLink(XhtmlMobileTextWriter)	已过时. 呈现链接元素的结束标记 (`</a>`)。此 API 已废弃不用。有关如何开发 ASP.NET 移动应用程序的信息，请参阅移动应用 & 具有 ASP.NET 的网站。
RenderOffPageVariables(XhtmlMobileTextWriter, Control, Int32)	已过时. 呈现子控件的隐藏回发变量，这些变量由于分页或辅助用户界面而不可见。此 API 已废弃不用。有关如何开发 ASP.NET 移动应用程序的信息，请参阅移动应用 & 具有 ASP.NET 的网站。
RenderOpeningListTag(XhtmlMobileTextWriter, String)	已过时. 呈现指定标记名称的开始标记。此 API 已废弃不用。有关如何开发 ASP.NET 移动应用程序的信息，请参阅移动应用 & 具有 ASP.NET 的网站。
RenderPostBackEventAsAnchor(XhtmlMobileTextWriter, String, String)	已过时. 将回发事件呈现为具有指定参数和文本的链接。此 API 已废弃不用。有关如何开发 ASP.NET 移动应用程序的信息，请参阅移动应用 & 具有 ASP.NET 的网站。
RenderPostBackEventAsAnchor(XhtmlMobileTextWriter, String, String, String)	已过时. 将回发事件呈现为具有指定参数、文本和访问键的链接。此 API 已废弃不用。有关如何开发 ASP.NET 移动应用程序的信息，请参阅移动应用 & 具有 ASP.NET 的网站。
RenderPostBackEventAsAnchor(XhtmlMobileTextWriter, String, String, String, Style, String)	已过时. 将回发事件呈现为链接，该链接具有指定参数、文本和访问键，并具有指定的样式或指定的级联样式表类名称。此 API 已废弃不用。有关如何开发 ASP.NET 移动应用程序的信息，请参阅移动应用 & 具有 ASP.NET 的网站。
SaveAdapterState()	已过时. 保存特定于此适配器的视图状态数据。此 API 已废弃不用。有关如何开发 ASP.NET 移动应用程序的信息，请参阅移动应用 & 具有 ASP.NET 的网站。
ToString()	已过时. 返回表示当前对象的字符串。 (继承自 Object)

适用于

XhtmlControlAdapter 类

定义

注解

继承者说明

构造函数

字段

属性

方法

适用于

另请参阅

反馈

其他资源