<DeviceSpecific> Element
Important This document may not represent best practices for current development, links to downloads and other resources may no longer be valid. Current recommended version can be found here. ArchiveDisclaimer

<DeviceSpecific> Element 

The <DeviceSpecific> element provides a construct for specifying a choice between multiple content alternatives within template sets and within controls that require device-specific choices. Within a <DeviceSpecific> element, you typically specify one or more <Choice> elements, each containing attributes that specify how to evaluate the choice against target device capabilities. At run time, each choice is evaluated in order, and the first choice that is successfully evaluated is used. Each <Choice> element can contain the following:

  • A Filter property that specifies the name of the device filter to evaluate.

  • Additional properties that override properties of the parent control.

  • Template definitions for the control.

The choice element always evaluates to true if the Filter property is omitted. If no other choice is declared before it is picked, the default choice is picked.


Property Description


Returns the collection of choices in a <DeviceSpecific> element.


Returns true if the currently selected choice of the <DeviceSpecific>/<Choice> construct has templates defined inside it.


Returns the mobile page containing this <DeviceSpecific> element.


Returns the owner of this <DeviceSpecific> element, either a control or a style.


Returns the currently selected choice, or null if none are applicable.

Containment Rules

The following controls can contain a <DeviceSpecific> element.

Control Comments


A MobileControl control, or any control that inherits from a MobileControl object, can contain zero or one <DeviceSpecific> elements.


A Style control, or any element that inherits from a Style object, can contain zero or one <DeviceSpecific> elements.

A <DeviceSpecific> element can contain the following controls.

Control Comments


A <DeviceSpecific> element can contain any number of DeviceSpecificChoice controls.


This example uses the PrefersGIF and PrefersWBMP device filters to choose among three image URLs based on device capabilities.


The specified device filters must be available in the Web.config file. For more information, see Mobile Device Capabilities.

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

See Also

© 2015 Microsoft