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

Fornisce la funzionalità di filtro per la classe MobileCapabilities.

<filter name="capability"
        compare="capabilityName"
        argument="argument" />
<filter name="capability"
        type="className"
        method="methodName" />

Attributi ed elementi

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

Attributi

Attributo

Descrizione

argument

Attributo String facoltativo.

Specifica l'argomento con cui deve essere confrontata la funzionalità. Se viene definito l'attributo compare, questo attributo è obbligatorio.

compare

Attributo String facoltativo.

Specifica la funzionalità del browser valutata dall'analizzatore di confronto. Può trattarsi di una funzionalità incorporata o del nome di qualsiasi altro analizzatore di funzionalità personalizzato. Se si specifica un filtro di confronto, questo attributo è obbligatorio.

method

Attributo String facoltativo.

Specifica il metodo che fornisce il delegato di valutazione. Viene utilizzato quando si specifica un filtro basato su delegati evaluator. Se si specifica l'attributo type, questo attributo è obbligatorio e non possibile specificare gli attributi compare e argument.

name

Attributo String obbligatorio.

Specifica il nome univoco con cui deve essere identificato il filtro.

NotaNota
Un filtro creato successivamente nel file di configurazione o nella gerarchia del file di configurazione e che abbia lo stesso nome di un filtro definito in precedenza esegue l'override del filtro precedentemente definito.

type

Attributo String facoltativo.

Specifica il tipo di classe che fornisce il delegato di valutazione.

Elementi figlio

Nessuno.

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.

deviceFilters

Specifica una periferica o una classe di periferica nel sistema MobileCapabilities ASP.NET in base all'agente utente o al browser.

Note

Quando si crea un'applicazione Web con contenuto specifico di una periferica, è necessario aggiungere uno o più filtri in una sezione deviceFilters del file di configurazione. Ciascun filtro specifica alcuni criteri in base ai quali individuare i dispositivi di destinazione.

La configurazione dei filtri di periferica offre un meccanismo di valutazione per due tipi di filtri: un filtro basato sul confronto e un filtro basato su delegati evaluator. La sintassi specifica entrambi i tipi di filtro. Il primo filtro mostra il filtro basato sul confronto e il secondo mostra il filtro basato sui delegati evaluator. Per informazioni dettagliate sulla creazione di filtri nel file di configurazione, vedere Rendering specifico di dispositivo.

I filtri di periferica sono soggetti alla distinzione tra maiuscole e minuscole. Un filtro denominato "isColor" è diverso da un filtro denominato "IsColor".

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. Il primo filtro mostra il filtro basato su confronto e il secondo mostra il filtro basato su delegati evaluator.

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

Informazioni sull'elemento

Gestore della sezione di configurazione

System.Web.Mobile.DeviceFiltersSection

Membro di configurazione

SystemWebSectionGroup.DeviceFilters

DeviceSpecificChoice.Filter

Percorsi configurabili

Machine.config

Web.config a livello di radice

Web.config a livello di applicazione

Web.config a livello di directory fisica o virtuale

Requisiti

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 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