filter, élément de deviceFilters (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.]

Offre une fonctionnalité de filtrage pour la classe MobileCapabilities.

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

Attributs et éléments

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

Attributs

Attribut	Description
argument	Attribut String facultatif. Spécifie l'argument auquel la fonctionnalité doit être comparée. Si l'attribut compare est défini, cet attribut est requis.
compare	Attribut String facultatif. Spécifie la fonctionnalité de navigateur évaluée par l'évaluateur de comparaison. Il peut s'agir de n'importe quelle fonctionnalité intégrée ou du nom d'un autre évaluateur de fonctionnalité personnalisé. Si vous spécifiez un filtre de comparaison, cet attribut est requis.
method	Attribut String facultatif. Spécifie la méthode qui fournit le délégué évaluateur. Utilisé lors de la spécification d'un filtre de délégué évaluateur. Lorsque l'attribut type est spécifié, cet attribut est requis et les attributs compare et argument ne peuvent pas être spécifiés.
name	Attribut String requis. Spécifie le nom unique par lequel le filtre doit être identifié. Note Si un filtre possède le même nom qu'un filtre défini antérieurement (soit plus loin dans le fichier de configuration, soit plus loin dans la hiérarchie des fichiers de configuration), le dernier filtre défini se substitue au premier.
type	Attribut String facultatif. Spécifie le type de classe qui fournit le délégué évaluateur.

Éléments enfants

Aucun

Éléments parents

Notes

Lorsque vous créez une application Web qui possède un contenu spécifique à l'appareil, vous devez ajouter un ou plusieurs filtres à une section deviceFilters du fichier de configuration. Chaque filtre spécifie des critères auxquels doivent correspondre les appareils cibles.

La configuration des filtres pour appareil mobile fournit un mécanisme d'évaluation pour deux types de filtres : le filtre de comparaison et le filtre de délégué évaluateur. La syntaxe spécifie les deux types de filtres. Le premier filtre correspond au filtre de comparaison alors que le second filtre correspond au filtre de délégué évaluateur. Pour plus d'informations sur la création de filtres dans le fichier de configuration, consultez Device-Specific Rendering.

Les filtres pour appareil mobile respectent la casse. Un filtre nommé « isColor » et un filtre nommé « IsColor » sont considérés comme différents.

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. Le premier filtre correspond à un filtre de comparaison alors que le second filtre correspond à un filtre de délégué évaluateur.

<deviceFilters>
  <filter name="IsHtml" 
    compare="PreferredRendering" 
    argument="html32" />
  <filter name="IsGPSEnabled" 
    type="Application1.CapabilityEvaluators1,Application1" 
    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)

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