deviceFilters, élément (Schéma des paramètres ASP.NET)

[Cette documentation constitue un aperçu et pourra faire l'objet de modifications dans les versions ultérieures. Des rubriques vierges sont incluses en tant qu'espaces réservés.]

Spécifie un appareil ou une classe d'appareil dans le système MobileCapabilities ASP.NET en fonction de l'agent utilisateur (user agent) ou du navigateur. Un filtre pour appareil mobile peut être utilisé par un développeur de pages ou d'applications pour substituer des propriétés de contrôle ou pour définir des blocs de contenu ou de modèles pour modifier la disposition et l'apparence.

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

Attributs et éléments

Les sections suivantes décrivent des attributs, des éléments enfants et des éléments parents.

Attributs

Aucun

Éléments enfants

Éléments parents

Notes

Vous pouvez sélectionner deux types de filtres pour appareil mobile : les évaluateurs de comparaison ou les délégués évaluateurs.

Pour les comparaisons simples, vous pouvez spécifier un filtre de comparaison en indiquant le nom d'une fonctionnalité et une valeur à comparer. Au moment de l'exécution, le filtre de périphérique prend la valeur true si la valeur de la fonctionnalité et la valeur fournie sont équivalentes. Les propriétés Boolean sont comparées sans respect de la casse ; par conséquent, les valeurs true et True sont toutes les deux valides. D'autres comparaisons de propriétés respectent la casse.

Pour réaliser une évaluation complexe, vous pouvez spécifier un filtre de délégué évaluateur, en indiquant la classe et le nom d'une méthode. Au moment de l'exécution, la méthode fournie est appelée pour déterminer si le filtre de périphérique a la valeur true.

Configuration par défaut

L'élément <deviceFilters> par défaut suivant n'est pas configuré explicitement dans le fichier de configuration machine ou dans le fichier racine Web.config, mais il s'agit de la configuration par défaut retournée par une application dans le .NET Framework version 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>

Exemple

L'exemple suivant configure à la fois un filtre de comparaison et un filtre du délégué évaluateur.

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

Informations sur les éléments

Voir aussi

Tâches

How to: Configure Specific Folders Using Location Settings

How to: Lock ASP.NET Configuration Settings

Référence

system.web, élément (Schéma des paramètres ASP.NET)

configuration, élément (Schéma des paramètres généraux)

filter, élément de deviceFilters (Schéma des paramètres ASP.NET)

mobileControls, élément (Schéma des paramètres ASP.NET)

MobileCapabilities

System.Configuration

System.Web.Configuration

Concepts

ASP.NET Configuration File Hierarchy

Securing Configuration

Configuration Inheritance

Autres ressources

Using Device Filters

ASP.NET Mobile Web Pages

Creating ASP.NET Mobile Web Applications

Paramètres généraux de configuration (ASP.NET)

Paramètres de configuration ASP.NET

Configuring ASP.NET Applications

ASP.NET Configuration Files

ASP.NET Configuration API