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

Article
09/04/2008

Mise à jour : novembre 2007

Offre une fonctionnalité de filtrage pour la classe MobileCapabilities.

configuration, élément (Schéma des paramètres généraux)
  system.web, élément (Schéma des paramètres ASP.NET)
    deviceFilters, élément (Schéma des paramètres ASP.NET)
      filter, élément de deviceFilters (Schéma des paramètres ASP.NET)

<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

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

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

Élément	Description
configuration	Élément racine obligatoire de chaque fichier de configuration utilisé par le Common Language Runtime et les applications .NET Framework.
system.web	Spécifie l'élément racine pour les paramètres de configuration ASP.NET dans un fichier de configuration. Contient des éléments de configuration qui configurent les applications Web ASP.NET et contrôlent le comportement des applications.
deviceFilters	Spécifie un périphérique ou une classe de périphérique dans le système MobileCapabilities ASP.NET en fonction de l'agent utilisateur (user agent) ou du navigateur.

Notes

Lorsque vous créez une application Web qui possède un contenu spécifique au périphérique, 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 périphériques cibles.

La configuration des filtres de périphérique 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 Rendu spécifique au périphérique.

Les filtres de périphériques 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

Gestionnaire de section de configuration	System.Web.Mobile.DeviceFiltersSection
Membre de configuration	SystemWebSectionGroup.DeviceFilters DeviceSpecificChoice.Filter
Emplacements configurables	Machine.config Web.config de niveau racine Web.config de niveau application Web.config de niveau répertoire virtuel ou physique
Configuration requise	IIS 5.0, IIS 5.1 ou IIS 6.0 .NET Framework 1.1 ou 2.0 Visual Studio 2003, ou Visual Studio 2005

Voir aussi

Partager via

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

Attributs et éléments

Attributs

Éléments enfants

Éléments parents

Notes

Configuration par défaut

Exemple

Informations sur les éléments

Voir aussi

Tâches

Concepts

Référence

Autres ressources

Ressources supplémentaires