Attributi personalizzati per controlli mobili

Aggiornamento: novembre 2007

Tutti i controlli mobili ASP.NET consentono di impostare attributi personalizzati utilizzando l'interfaccia IAttributeAccessor delle pagine Web ASP.NET. In questa interfaccia sono disponibili i metodi GetAttribute e SetAttribute. La classe MobileControl inoltre espone un insieme denominato CustomAttributes.

Gli attributi personalizzati possono essere utilizzati sia per specificare nuovi attributi relativi a un controllo sia per regolare il rendering o il comportamento del controllo in un adattatore specifico del dispositivo.

Per impostazione predefinita, non è possibile impostare attributi personalizzati. Per attivarli, è possibile procedere in due modi diversi:

• Impostando un attributo della sezione <mobileControls> del file Web.config, così come indicato nell'esempio di codice riportato di seguito:

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

  Tale impostazione influisce sui valori predefiniti di tutte le pagine dell'applicazione.

• Impostando la proprietà AllowCustomAttributes della classe MobilePage su true. Tale impostazione influisce su tutti i controlli della pagina.

L'attributo wmlFormat per il controllo TextBox viene inviato ai dispositivi WML come attributo Format dell'elemento <input> WML. Si tratta di un attributo personalizzato, che si differenzia dagli attributi di prima classe del controllo. Per rendere operativi gli attributi personalizzati, occorre innanzitutto attivarli. Per un elenco completo dei formati validi, vedere la specifica WML disponibile nel forum WAP (Wireless Application Protocol) all'indirizzo http://www.wapforum.org (informazioni in lingua inglese).

L'attributo wmlFormat esegue l'override della proprietà Numeric per il controllo TextBox. Se ad esempio l'attributo wmlFormat è impostato su "NNN", nell'elemento <input> non potranno essere presenti più di tre caratteri numerici.

Nota:
È possibile che nomi di proprietà errati vengano scambiati per attributi personalizzati, quando questi ultimi sono attivati. Se ad esempio si digita per errore "Txet" per specificare la proprietà Text di un controllo, il parser salverà "Txet" come attributo personalizzato anziché generare un'eccezione. Per precauzione, gli attributi personalizzati sono disattivati per impostazione predefinita.

Vedere anche

Concetti

Configurazione di un'applicazione Web per più dispositivi

Suggerimenti per l'applicazione di filtri di periferica

Metodi di valutazione dei dispositivi

Funzionalità estese del browser

Riferimenti

HasCapability

MobileControl

Altre risorse

Creazione di controlli mobili personalizzati