Elemento deviceFilters (schema delle impostazioni ASP.NET)

Specifica una periferica o una classe di periferica nel sistema MobileCapabilities ASP.NET in base all'agente utente o al browser. Un filtro di periferica può essere utilizzato da uno sviluppatore di pagine o applicazioni per eseguire l'override delle proprietà dei controlli oppure per definire blocchi di contenuto o modelli per modificare il layout e l'aspetto.

<deviceFilters>
     <filter.../>
</deviceFilters>

Attributi ed elementi

Nelle sezioni seguenti vengono illustrati attributi, elementi figlio e padre.

Attributi

Nessuno.

Elementi figlio

Elemento

Descrizione

filter

Elemento facoltativo.

Fornisce la funzionalità di filtro per la classe MobileCapabilities. Nella sezione <deviceFilters> possono essere presenti uno o più elementi di filtro.

Elementi padre

Elemento

Descrizione

configuration

È l'elemento di primo livello necessario in ciascun file di configurazione utilizzato in Common Language Runtime e nelle applicazioni .NET Framework.

system.web

Specifica l'elemento di primo livello per le impostazioni di configurazione ASP.NET in un file di configurazione. Contiene gli elementi per la configurazione di applicazioni Web ASP.NET e il controllo del comportamento delle stesse.

Note

È possibile scegliere tra due tipi di filtri di periferica: analizzatori di confronto o delegati evaluator.

Per confronti semplici è possibile specificare un filtro basato sul confronto fornendo il nome di una funzionalità e un valore con cui eseguire il confronto. In fase di esecuzione il filtro di periferica restituisce true se il valore della funzionalità e il valore fornito sono uguali. Le proprietà booleane vengono confrontate senza distinzione tra maiuscole e minuscole; pertanto true e True sono entrambi valori validi. Le altre proprietà vengono confrontate rispettando le maiuscole e le minuscole.

Per valutazioni più complesse, è possibile specificare un filtro basato su delegati evaluator fornendo il nome della classe e il nome del metodo. In fase di esecuzione viene chiamato il metodo indicato per determinare se il filtro di periferica restituisce true.

Configurazione predefinita

Il seguente elemento <deviceFilters> predefinito non viene configurato in modo esplicito nel file di configurazione del computer o nel file Web.config a livello di radice, ma è la configurazione predefinita restituita da un'applicazione in .NET Framework versione 2.0.

<deviceFilters>
    <filter name="isJPhone" compare="Type" argument="J-Phone"/>
    <filter name="isHTML32" compare="PreferredRenderingType" argument="html32"/>
    <filter name="isWML11" compare="PreferredRenderingType" argument="wml11"/>
    <filter name="isCHTML10" compare="PreferredRenderingType" argument="chtml10"/>
    <filter name="isGoAmerica" compare="Browser" argument="Go.Web"/>
    <filter name="isMME" compare="Browser" argument="Microsoft Mobile Explorer"/>
    <filter name="isMyPalm" compare="Browser" argument="MyPalm"/>
    <filter name="isPocketIE" compare="Browser" argument="Pocket IE"/>
    <filter name="isUP3x" compare="Type" argument="Phone.com 3.x Browser"/>
    <filter name="isUP4x" compare="Type" argument="Phone.com 4.x Browser"/>
    <filter name="isEricssonR380" compare="Type" argument="Ericsson R380"/>
    <filter name="isNokia7110" compare="Type" argument="Nokia 7110"/>
    <filter name="prefersGIF" compare="PreferredImageMIME" argument="image/gif"/>
    <filter name="prefersWBMP" compare="PreferredImageMIME" argument="image/vnd.wap.wbmp"/>
    <filter name="supportsColor" compare="IsColor" argument="true"/>
    <filter name="supportsCookies" compare="Cookies" argument="true"/>
    <filter name="supportsJavaScript" compare="Javascript" argument="true"/>
    <filter name="supportsVoiceCalls" compare="CanInitiateVoiceCall" argument="true"/>
</deviceFilters>

Esempio

Nell'esempio di codice riportato di seguito vengono configurati un filtro di confronto e un filtro basato su delegati evaluator.

<deviceFilters>
  <filter name="IsHtml" 
    compare="PreferredRendering" 
    argument="html32" />
  <filter name="IsGPSEnabled" 
    type="MyApplication.MyCapabilityEvaluators,MyApplication" 
    method="IsGPSEnabled" />
</deviceFilters>

Informazioni sull'elemento

Configuration Section Handler

System.Web.Mobile.DeviceFiltersSection

Configuration Member

SystemWebSectionGroup.DeviceFilters

Configurable Locations

Machine.config

Web.config a livello di radice

Web.config a livello di applicazione

Web.config

Requirements

IIS 5.0, IIS 5.1 o IIS 6.0

.NET Framework 1.1 o 2.0

Visual Studio 2003 o Visual Studio 2005

Vedere anche

Attività

Procedura: configurare directory specifiche utilizzando impostazioni di percorso

Procedura: bloccare le impostazioni di configurazione di ASP.NET

Riferimenti

Elemento system.web (schema delle impostazioni ASP.NET)

Elemento configuration (schema delle impostazioni generali)

Elemento filter per deviceFilters (schema delle impostazioni ASP.NET)

Elemento mobileControls (schema delle impostazioni ASP.NET)

MobileCapabilities

System.Configuration

System.Web.Configuration

Concetti

Gerarchia ed ereditarietà dei file di configurazione di ASP.NET

Protezione della configurazione di ASP.NET

Scenari di configurazione ASP.NET

Altre risorse

Using Device Filters

ASP.NET Mobile Web Pages

Creazione di pagine Web ASP.NET per dispositivi mobili

Impostazioni di configurazione generali (ASP.NET)

Impostazioni di configurazione di ASP.NET

Amministrazione di siti Web ASP.NET

File di configurazione ASP.NET

API di configurazione di ASP.NET