Attributs personnalisés pour les contrôles mobiles

Mise à jour : novembre 2007

Tous les contrôles mobiles ASP.NET vous permettent de définir des attributs de contrôle personnalisés grâce à l'interface IAttributeAccessor des pages Web ASP.NET. Cette interface fournit les méthodes GetAttribute et SetAttribute. En outre, la classe MobileControl expose une collection nommée CustomAttributes.

Il est possible d'utiliser des attributs personnalisés pour spécifier les attributs supplémentaires d'un contrôle ; il est également possible de les utiliser dans un adaptateur spécifique au périphérique pour ajuster le comportement ou le rendu du contrôle.

Par défaut, la possibilité de définir des attributs personnalisés sur un contrôle est désactivée. Il existe deux façons d'activer les attributs personnalisés :

• En définissant un attribut de la section <mobileControls> dans le fichier Web.config, comme le montre l'exemple de code suivant :

  <configuration>
    <system.web>
          ...
        <mobileControls allowCustomAttributes="True" />
        ...
    </system.web>
  </configuration>
  

  Ce paramètre affecte la valeur par défaut de toutes les pages de l'application.

• En affectant à la propriété AllowCustomAttributes de la classe MobilePage la valeur true. Ce paramètre affecte tous les contrôles de la page.

L'attribut wmlFormat pour le contrôle TextBox est envoyé aux périphériques WML en tant qu'attribut Format de l'élément WML <input>. Il s'agit d'un attribut personnalisé distinct des attributs de première classe du contrôle. Cependant, pour pouvoir faire fonctionner les attributs personnalisés, vous devez les activer. Pour obtenir la liste complète des formats valides, consultez la spécification WML disponible sur le forum consacré au protocole WAP (Wireless Application Protocol), à l'adresse suivante : http://www.wapforum.org.

L'attribut wmlFormat substitue la propriété Numeric pour le contrôle TextBox. Par exemple, si l'attribut wmlFormat a la valeur "NNN", l'élément <input> est limité à trois caractères numériques.

Remarque :

Lorsque les attributs personnalisés sont activés, les propriétés dont les noms comportent des erreurs typographiques peuvent être interprétées à tort pour des attributs personnalisés. Par exemple, si vous spécifiez de manière incorrecte la propriété Text d'un contrôle en l'écrivant "Txet", l'analyseur l'enregistre en tant qu'attribut personnalisé nommé "Txet" au lieu de lever une exception. Par précaution, les attributs personnalisés ne sont pas autorisés par défaut.

Voir aussi

Concepts

Configuration d'une application Web pour plusieurs périphériques

Recommandations sur le filtrage de périphérique

Méthodes d'évaluation de périphérique

Fonctionnalités du navigateur étendues

Référence

HasCapability

MobileControl

Autres ressources

Création de contrôles mobiles personnalisés