Partager via


<DeviceSpecific>, élément

Mise à jour : novembre 2007

L'élément <DeviceSpecific> fournit une construction qui permet de spécifier un choix entre plusieurs types de contenus dans les ensembles de modèles et les contrôles nécessitant des choix spécifiques au périphérique. Dans un élément <DeviceSpecific>, vous spécifiez généralement un ou plusieurs éléments <Choice>, chacun d'eux contenant des attributs qui indiquent la façon dont le choix doit être évalué par rapport aux fonctionnalités du périphérique cible. Au moment de l'exécution, chaque choix est évalué dans l'ordre ; le premier choix dont l'évaluation réussit est utilisé. Chaque élément <Choice> peut contenir ce qui suit :

  • Une propriété Filter, qui spécifie le nom du filtre de périphérique à évaluer.

  • Des propriétés supplémentaires qui se substituent aux propriétés du contrôle parent.

  • Des définitions de modèles pour le contrôle.

L'élément Choice a toujours la valeur true si la propriété Filter est omise. Si aucun autre choix n'est déclaré avant la sélection, le choix par défaut est retenu.

Propriétés

Propriété

Description

Choices

Retourne la collection de choix d'un élément <DeviceSpecific>.

HasTemplates

Retourne la valeur true si le choix actuellement sélectionné de la construction <DeviceSpecific>/<Choice> possède des modèles définis.

MobilePage

Retourne la page mobile contenant l'élément <DeviceSpecific>.

Owner

Retourne le propriétaire de l'élément <DeviceSpecific>, soit un contrôle soit un style.

SelectedChoice

Retourne le choix actuellement sélectionné, ou null si aucun choix n'est applicable.

Règles relatives à la relation contenant-contenu

Les contrôles suivants peuvent contenir un élément <DeviceSpecific>.

Contrôle

Commentaires

MobileControl

Un contrôle MobileControl, ou tout contrôle qui hérite d'un objet MobileControl, peut contenir zéro ou un élément <DeviceSpecific>.

Style

Un contrôle Style, ou tout élément qui hérite d'un objet Style, peut contenir zéro ou un élément <DeviceSpecific>.

Un élément <DeviceSpecific> peut contenir les contrôles ci-dessous.

Contrôle

Commentaires

DeviceSpecificChoice

Un élément <DeviceSpecific> peut contenir n'importe quel nombre de contrôles DeviceSpecificChoice.

Exemple

Description

Cet exemple utilise les filtres de périphérique PrefersGIF et PrefersWBMP pour choisir l'une des trois images d'URL d'après les fonctionnalités du périphérique.

Remarque :

Les filtres de périphérique spécifiés doivent être disponibles dans le fichier Web.config. Pour plus d'informations, consultez Fonctionnalités des périphériques mobiles.

Code

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

Voir aussi

Concepts

Informations de référence sur les contrôles mobiles

Référence

<Choice>, élément (Guide du développeur .NET Framework)

Autres ressources

Guide de référence des éléments