Elemento <DeviceSpecific>

Actualización: noviembre 2007

El elemento <DeviceSpecific> proporciona una construcción que permite especificar una elección entre varias alternativas de contenido incluidas en conjuntos de plantillas y en controles que requieran opciones específicas del dispositivo. En un elemento <DeviceSpecific>, se suele especificar uno o más elementos <Choice>; cada uno contiene atributos que especifican cómo se evalúa la opción comparándola con las funciones del dispositivo de destino. En tiempo de ejecución, cada opción se evalúa en orden secuencial, y se utiliza la primera opción que se evalúa satisfactoriamente. Cada elemento <Choice> puede contener lo siguiente:

• Una propiedad Filter que especifique el nombre del filtro de dispositivos que se evalúa.

• Propiedades adicionales que reemplacen propiedades del control principal.

• Definiciones de plantillas para el control.

El elemento Choice siempre se evalúa como true si se omite la propiedad Filter. Si no se declara ninguna otra opción, se seleccionará la opción predeterminada.

Propiedades

Propiedad	Descripción
Choices	Devuelve la colección de opciones de un elemento <DeviceSpecific>.
HasTemplates	Devuelve true si la opción seleccionada actualmente en la construcción <DeviceSpecific>/<Choice> tiene definidas plantillas en su interior.
MobilePage	Devuelve la página móvil que contiene este elemento <DeviceSpecific>.
Owner	Devuelve el propietario de este elemento <DeviceSpecific>, ya sea un control o un estilo.
SelectedChoice	Devuelve la opción seleccionada actualmente o null si no se puede aplicar ninguna.

Reglas de contención

Los controles siguientes pueden contener un elemento <DeviceSpecific>.

Control	Comentarios
MobileControl	Un control MobileControl o cualquier control que herede de un objeto MobileControl puede contener cero o un elemento <DeviceSpecific>.
Style	Un control Style o cualquier elemento que herede de un objeto Style puede contener cero o un elemento <DeviceSpecific>.

Un elemento <DeviceSpecific> puede contener los controles siguientes.

Control	Comentarios
DeviceSpecificChoice	Un elemento <DeviceSpecific> puede contener cualquier número de controles DeviceSpecificChoice.

Ejemplo

Descripción

En este ejemplo se usan los filtros de dispositivo PrefersGIF y PrefersWBMP para elegir entre tres direcciones URL de imágenes basándose en la funcionalidad del dispositivo.

Nota:
Los filtros de dispositivos especificados deben estar disponibles en el archivo Web.config. Para obtener más información, vea Funciones de dispositivos móviles.

Código

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

Vea también

Conceptos

Referencia de controles móviles

Referencia

<Choice> (Elemento, Guía del desarrollador de .NET Framework)

Otros recursos

Referencia de elementos