Elemento <DeviceSpecific>

  • Articolo

L'elemento <DeviceSpecific> rappresenta un costrutto con il quale specificare un'opzione tra più alternative di contenuto presenti in insiemi di modelli e controlli che richiedono la scelta tra opzioni specifiche di dispositivo. Nell'elemento <DeviceSpecific> vengono specificati in genere uno o più elementi <Choice>, ognuno dei quali contiene attributi che consentono di specificare le modalità di valutazione dell'opzione rispetto alle funzionalità dei dispositivi di destinazione. In fase di esecuzione, ogni opzione viene valutata in base a un ordine, quindi viene utilizzata la prima opzione la cui valutazione ha esito positivo. In ogni elemento <Choice> può essere incluso quanto indicato di seguito.

  • Una proprietà Filter che consente di specificare il nome del filtro di dispositivo da valutare.
  • Proprietà aggiuntive che eseguono l'override delle proprietà del controllo padre.
  • Definizioni dei modelli per il controllo.

L'elemento di opzione restituisce sempre true se la proprietà Filter viene omessa. Se prima del prelievo non viene dichiarata nessun'altra opzione, verrà prelevata l'opzione predefinita.

Sintassi dei controlli mobili

Le proprietà obbligatorie e gli elementi con funzione di codice sono evidenziati in grassetto.

<DeviceSpecific>
        Add choices here.
</DeviceSpecific>

Proprietà

Proprietà Descrizione
Choices Restituisce l'insieme di opzioni in un elemento <DeviceSpecific>.
HasTemplates Restituisce true se nell'opzione correntemente selezionata del costrutto DeviceSpecific/Choice sono inclusi modelli definiti.
MobilePage Restituisce la pagina mobile che contiene l'elemento <DeviceSpecific>.
Owner Restituisce il proprietario dell'elemento <DeviceSpecific>, sia esso un controllo o uno stile.
SelectedChoice Restituisce l'opzione correntemente selezionata o il valore null se non è applicabile alcuna scelta.

Regole di contenimento

L'elemento <DeviceSpecific> può essere incluso nei controlli indicati di seguito.

Controllo Commenti
System.Web.UI.MobileControls.MobileControl Controllo MobileControl oppure qualsiasi controllo che eredita da un oggetto MobileControl, può contenere 0 o 1 elementi DeviceSpecific.
System.Web.UI.MobileControls.Style Controllo Style oppure qualsiasi elemento che eredita da un oggetto Style, può contenere 0 o 1 elementi DeviceSpecific.

In un elemento <DeviceSpecific> possono essere inclusi i controlli indicati di seguito.

Controllo Commenti
System.Web.UI.MobileControls.DeviceSpecificChoice Un elemento DeviceSpecific può contenere un numero qualsiasi di controlli DeviceSpecificChoice.

Esempio

In questo esempio i filtri di dispositivo PrefersGIF e PrefersWBMP vengono utilizzati per scegliere tra tre URL di immagini in base alle funzionalità dei dispositivi.

Nota   I filtri di dispositivo specificati devono essere disponibili nel file web.config. Per ulteriori informazioni, vedere la documentazione Funzionalità dei dispositivi mobili.

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