Elemento <DeviceSpecific>

Aggiornamento: novembre 2007

L'elemento <DeviceSpecific> rappresenta un costrutto con il quale specificare un'opzione tra più alternative di contenuto presenti in insiemi di modelli e in 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 contenuto quanto indicato di seguito:

  • Una proprietà Filter che consente di specificare il nome del filtro di periferica 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.

Proprietà

Proprietà

Descrizione

Choices

Restituisce l'insieme di opzioni in un elemento <DeviceSpecific>.

HasTemplates

Restituisce true se nell'opzione attualmente selezionata del costrutto <DeviceSpecific>/<Choice> sono inclusi modelli definiti.

MobilePage

Restituisce la pagina per dispositivi mobili contenente l'elemento <DeviceSpecific>.

Owner

Restituisce il proprietario dell'elemento <DeviceSpecific>, sia esso un controllo o uno stile.

SelectedChoice

Restituisce l'opzione attualmente selezionata o il valore null se non vi sono opzioni applicabili.

Regole di contenimento

Nei controlli descritti di seguito può essere contenuto un elemento <DeviceSpecific>.

Controllo

Commenti

MobileControl

Il controllo MobileControl, o qualsiasi controllo che eredita da un oggetto MobileControl, può contenere o meno un elemento <DeviceSpecific>.

Style

Il controllo Style, o qualsiasi elemento che eredita da un oggetto Style, può contenere o meno un elemento <DeviceSpecific>.

In un elemento <DeviceSpecific> possono essere contenuti i controlli riportati di seguito.

Controllo

Commenti

DeviceSpecificChoice

In un elemento <DeviceSpecific> può essere contenuto un numero qualsiasi di controlli DeviceSpecificChoice.

Esempio

Descrizione

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

Nota:

I filtri di periferica specificati devono essere disponibili nel file Web.config. Per ulteriori informazioni, vedere Funzionalità dei dispositivi mobili.

Codice

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

Vedere anche

Concetti

Riferimento ai controlli mobili

Riferimenti

Elemento <Choice> (Guida per gli sviluppatori di .NET Framework)

Altre risorse

Riferimento agli elementi