Classe DeviceFilter

Article
03/22/2024

Spécifie des critères afin de déterminer les fonctionnalités du navigateur mobile ou le type d’appareil mobile.

Syntaxe

class DeviceFilter : CollectionElement

Méthodes

Cette classe ne contient pas de méthodes.

Propriétés

Le tableau suivant répertorie les propriétés exposées par la classe DeviceFilter.

Nom	Description
`Argument`	Valeur `string` en lecture/écriture qui spécifie un mot clé à comparer. La propriété `Compare` spécifie la catégorie du mot clé.
`Compare`	Valeur `string` en lecture/écriture qui spécifie la catégorie d’un mot clé à comparer. La propriété `Argument` spécifie le mot clé à comparer.
`Method`	Valeur `string` en lecture/écriture qui contient le nom d’une méthode à utiliser dans un filtre évaluateur-délégué. La méthode détermine si le filtre pour appareil mobile est évalué à `true`. Si vous spécifiez une valeur pour cette propriété, vous devez également spécifier une valeur pour la propriété `Type`.
`Name`	Valeur `string` de lecture/écriture unique requise qui spécifie le nom du filtre pour appareil mobile. La propriété clé.
`Type`	Valeur `string` en lecture/écriture qui spécifie la classe d’une méthode déléguée d’évaluateur. Si vous spécifiez une valeur pour cette propriété, vous devez également spécifier une valeur pour la propriété `Method`.

Sous-classes

Cette classe ne contient aucune sous-classe.

Notes

Les instances de cette classe sont contenues dans la propriété DeviceFilters de la classe DeviceFiltersSection.

Les propriétés de cette classe spécifient des critères par rapport auxquels les appareils mobiles et les fonctionnalités cibles doivent être mis en correspondance. Vous pouvez choisir parmi deux types de filtres pour appareil mobile : les évaluateurs de comparaison ou les délégués évaluateurs.

Pour le filtre basé sur la comparaison, vous utilisez les propriétés Compare et Argument pour spécifier une fonctionnalité et la valeur que vous souhaitez que le filtre compare. Au moment de l’exécution, l’évaluateur réussit si la valeur que vous fournissez et la valeur retournée sont égales. Les propriétés booléennes comparées ne sont pas sensibles à la casse (par exemple, « true » et « True » sont considérées comme égales). Les autres propriétés comparées sont sensibles à la casse.

Vous pouvez implémenter des évaluations plus complexes en spécifiant un filtre basé sur un évaluateur délégué. Ce type de filtre délègue l’évaluation à une méthode que vous créez. Pour implémenter une méthode évaluateur-délégué, spécifiez le nom de la méthode dans la propriété Method et la classe de la méthode dans la propriété Type. Au moment de l’exécution, la méthode que vous avez spécifiée est appelée pour effectuer l’évaluation.

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

Hiérarchie d'héritage

CollectionElement

DeviceFilter

Spécifications

Type	Description
Client	- IIS 7.0 sur Windows Vista - IIS 7.5 sous Windows 7 - IIS 8.0 sous Windows 8 - IIS 10.0 sous Windows 10
Serveur	- IIS 7.0 sur Windows Server 2008 - IIS 7.5 sur Windows Server 2008 R2 - IIS 8.0 sur Windows Server 2012 - IIS 8.5 sur Windows Server 2012 R2 - IIS 10.0 sous Windows Server 2016
Produit	- IIS 7.0, IIS 7.5, IIS 8.0, IIS 8.5, IIS 10.0
Fichier MOF	WebAdministration.mof

Voir aussi

Élément de <filtre>System.Web.Configuration.SystemWebSectionGroup.DeviceFilters
Affichage spécifique à l’appareil
Classe CollectionElement
Classe DeviceFiltersSection
Classe System.Web.Mobile.MobileCapabilities

Partager via