deviceFilters, élément (Schéma des paramètres ASP.NET)
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ément |
Description |
|---|---|
filter |
Élément facultatif. Offre une fonctionnalité de filtrage pour la classe MobileCapabilities. La section <deviceFilters> peut contenir un ou plusieurs éléments de filtre. |
É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 qui configurent les applications Web ASP.NET et contrôlent le comportement des applications. |
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 pour appareil mobile 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 pour appareil mobile 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
Configuration Section Handler |
|
Configuration Member |
|
Configurable Locations |
Machine.config Web.config de niveau racine Web.config au niveau de l'application Web.config |
Requirements |
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
Tâches
Comment : configurer des répertoires spécifiques à l'aide des paramètres d'emplacement
Comment : verrouiller des paramètres de configuration ASP.NET
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)
Concepts
Hiérarchie du fichier de configuration ASP.NET et héritage
Sécurisation de la configuration ASP.NET
Scénarios de configuration ASP.NET
Autres ressources
Création de pages Web mobiles ASP.NET
Paramètres généraux de configuration (ASP.NET)
Paramètres de configuration ASP.NET
Administration de site Web ASP.NET