Attributs personnalisés

Tous les contrôles mobiles ASP.NET permettent au développeur de définir des attributs de contrôle personnalisés grâce à l'interface IAttributeAccessor des Web Forms. Cette interface fournit les méthodes IAttributeAccessor.GetAttribute et IAttributeAccessor.SetAttribute ; en outre, la classe MobileControl expose un dictionnaire appelé 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 dans la section <mobileControls> de 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 du contrôle TextBox est envoyé aux périphériques WML en tant que propriété 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.

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

Attention   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 ont la valeur off par défaut.

Voir aussi

Configuration d'une application Web pour plusieurs périphériques | Recommandations sur le filtrage de périphérique | HasCapability, méthode | Méthodes d'évaluation de périphérique | Fonctionnalités du navigateur étendues | MobileControl, classe