<DeviceSpecific> 元素

更新:2007 年 11 月

<DeviceSpecific> 元素提供一个构造,用于在要求特定于设备的选项的模板集和控件内在多个备选内容之间指定一个选项。在 <DeviceSpecific> 元素内,通常指定一个或多个 <Choice> 元素,每个元素都包含指定如何根据目标设备功能计算选项的属性。运行时依次计算每个选项,并使用成功计算出的第一个选项。每个 <Choice> 元素都可以包含以下内容:

  • 指定要计算的设备筛选器的名称的 Filter 属性。

  • 重写父控件属性的附加属性。

  • 控件的模板定义。

如果省略 Filter 属性,则选项元素的计算结果始终为 true。如果在选取前没有声明任何其他选项,则选取默认选项。

属性

属性

说明

Choices

返回 <DeviceSpecific> 元素中的选项的集合。

HasTemplates

如果 <DeviceSpecific>/<Choice> 构造的当前选定选项在选项内部定义了模板,则返回 true。

MobilePage

返回包含此 <DeviceSpecific> 元素的移动页。

Owner

返回此 <DeviceSpecific> 元素的所有者,该所有者是一个控件或样式。

SelectedChoice

返回当前选定的选项,如果没有适用的选项,则为 null。

包容规则

以下控件可以包含 <DeviceSpecific> 元素。

控件

注释

MobileControl

MobileControl 控件或从 MobileControl 对象继承的任何控件可以包含零或一个 <DeviceSpecific> 元素。

Style

Style 控件或从 Style 对象继承的任何元素可以包含零或一个 <DeviceSpecific> 元素。

<DeviceSpecific> 元素可包含以下控件。

控件

注释

DeviceSpecificChoice

<DeviceSpecific> 元素可以包含任意多个 DeviceSpecificChoice 控件。

示例

说明

此示例使用 PrefersGIF 和 PrefersWBMP 设备筛选器基于设备功能在三个图像 URL 之间进行选择。

说明:

指定的设备筛选器必须可用于 Web.config 文件。有关更多信息,请参见移动设备功能

代码

<DeviceSpecific>
  <Choice Filter="PrefersGIF" ImageUrl="colorImg.gif"/>
  <Choice Filter="PrefersWBMP" ImageUrl="myImage.wbmp"/>
  <Choice ImageUrl="monoImg.gif"/>
</DeviceSpecific>

请参见

概念

移动控件参考

参考

<Choice> 元素(《.NET Framework 开发人员指南》)

其他资源

元素参考