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

Article
08/10/2011

Cet élément spécifie une liste de chaînes de recherche qui permettent d'appliquer des paramètres individuels à des définitions de navigateur spécifiques.

Remarque
L'utilisation de l'élément browserCaps dans le fichier Web.config pour définir des navigateurs est déconseillée dans le .NET Framework 2.0 mais encore prise en charge.Les données de cet élément sont fusionnées avec les informations issues des fichiers de définition de navigateur (.browser) situés dans le dossier %SystemRoot%\Microsoft.NET\Framework\version\CONFIG\Browsers au niveau de l'ordinateur et dans tous les dossiers App_Browsers existants au niveau des applications.Pour plus d'informations, consultez Schéma du fichier de définition de navigateur (élément browsers).

L'utilisation de l'élément browserCaps dans le fichier Web.config pour définir des navigateurs est déconseillée dans le .NET Framework 2.0 mais encore prise en charge.Les données de cet élément sont fusionnées avec les informations issues des fichiers de définition de navigateur (.browser) situés dans le dossier %SystemRoot%\Microsoft.NET\Framework\version\CONFIG\Browsers au niveau de l'ordinateur et dans tous les dossiers App_Browsers existants au niveau des applications.Pour plus d'informations, consultez Schéma du fichier de définition de navigateur (élément browsers).

<filter> 
   [assignments, filter elements and case elements]
<filter>
<filter 
   match="[regular expression]" 
   with="[regular expression]" >
   [browser capability assignments, filter elements, case elements]
</filter>
<filter>
   <case>...</case>
</filter>

Attributs et éléments

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

Attributs

Attribut	Description
match	Attribut String facultatif. Spécifie une expression régulière .NET Framework qui est testée par rapport à l'attribut with. Si cet attribut est omis, la correspondance est supposée établie.
with	Attribut String facultatif. Spécifie une chaîne ou une expression régulière du .NET Framework à rechercher. En cas d'omission, c'est la chaîne spécifiée par l'élément use qui est utilisée.

match

Attribut String facultatif.

Spécifie une expression régulière .NET Framework qui est testée par rapport à l'attribut with. Si cet attribut est omis, la correspondance est supposée établie.

with

Attribut String facultatif.

Spécifie une chaîne ou une expression régulière du .NET Framework à rechercher. En cas d'omission, c'est la chaîne spécifiée par l'élément use qui est utilisée.

Éléments enfants

Élément	Description
case	Désactive les critères spéciaux après le traitement de la première extraction d'un certain nombre de possibilités.

Éléments parents

Élément	Description
configuration	Spécifie l'élément racine requis dans chaque fichier de configuration utilisé par le Common Language Runtime et les applications .NET Framework.
system.web	Spécifie l'élément racine des paramètres de configuration ASP.NET dans un fichier de configuration et contient des éléments de configuration qui configurent des applications Web ASP.NET et contrôlent le comportement des applications.
browserCaps	Spécifie les paramètres des navigateurs pris en charge et les fonctions des navigateurs. L'élément browserCaps peut être mis à jour si nécessaire pour spécifier de nouveaux navigateurs et leurs fonctions. Pour obtenir la liste des propriétés valides pour les navigateurs, consultez HttpBrowserCapabilities.

configuration

Spécifie l'élément racine requis dans chaque fichier de configuration utilisé par le Common Language Runtime et les applications .NET Framework.

system.web

Spécifie l'élément racine des paramètres de configuration ASP.NET dans un fichier de configuration et contient des éléments de configuration qui configurent des applications Web ASP.NET et contrôlent le comportement des applications.

browserCaps

Spécifie les paramètres des navigateurs pris en charge et les fonctions des navigateurs. L'élément browserCaps peut être mis à jour si nécessaire pour spécifier de nouveaux navigateurs et leurs fonctions.

Pour obtenir la liste des propriétés valides pour les navigateurs, consultez HttpBrowserCapabilities.

Notes

L'élément browserCaps spécifie une liste de chaînes de recherche qui permettent d'appliquer des paramètres individuels à des définitions de navigateur spécifiques. Les règles contenues dans la liste sont appliquées dans l'ordre. Le premier élément case enfant trouvé est évalué et les autres éléments case enfants sont ignorés.

Configuration par défaut

Dans le .NET Framework version 2.0, l'élément filter n'est pas configuré parce que l'élément browserCaps est déconseillé en faveur de l'utilisation de fichiers de définition de navigateur pour spécifier les navigateurs pris en charge et leurs fonctions. Pour plus d'informations, consultez Schéma du fichier de définition de navigateur (élément browsers).

Dans les versions 1.0 et 1.1 du .NET Framework, les éléments filter par défaut configurés dans le fichier Machine.config sont trop nombreux pour être répertoriés ici. Pour des mises à jour des données du navigateur, rendez-vous à l'adresse http://www.cyscape.com/browsercaps. Des mises à jour périodiques des périphériques remplacent cette section sur les fonctions du navigateur.

Exemple

L'exemple de code suivant illustre l'analyse de l'en-tête HTTP User-Agent pour n'importe quelle version de Microsoft Internet Explorer, tant que le format de la chaîne User-Agent reste à peu près identique.

L'exemple utilise les expressions régulières du .NET Framework et la capacité des expressions régulières à capturer des sous-expressions afin de déplacer directement des numéros de version de la chaîne User-Agent vers l'élément browserCaps.

Le fichier spécifie les paires nom/valeur sous la forme d'instructions d'assignation, qui sont similaires aux fichiers browscap.ini des services IIS (Internet Information Services). Par exemple, la ligne "browser=IE" affecte au champ de navigateur la valeur de chaîne "IE".

<configuration>
   <browserCaps>
      <result type="System.Web.HttpBrowserCapabilities, System.Web"/>
      <use var="HTTP_USER_AGENT"/>
      browser=Unknown
      version=0.0
      majorversion=0
      minorversion=0
      frames=false
      tables=false
      cookies=false
      backgroundsounds=false
      <filter>
         <case match="^Mozilla[^(]*\(compatible; MSIE 
            (?'ver'(?'major'\d+)(?'minor'\.\d+)(?'letters'\w*))
            (?'extra'.*)">
            browser=IE
            version=${ver}
            majorver=${major}
            minorver=${minor}
            <case match="^2\." with="%{version}">
               tables=true
               cookies=true
               backgroundsounds=true
               <case match="2\.5b" with="%{version}">
                  beta=true
               </case>
            </case>
         </case>
      </filter>
   </browsercaps>
</configuration>

Informations sur les éléments

Gestionnaire de section de configuration	HttpCapabilitiesSectionHandler
Membre de configuration	Browsers
Emplacements configurables	Machine.config Web.config racine Web.config au niveau de l'application Web.config de niveau répertoire virtuel ou physique
Configuration requise	Microsoft Internet Information Services (IIS) version 5.0, 5.1 ou 6.0 .NET Framework version 2.0 (déconseillé), 1.1 ou 1.0 Microsoft Visual Studio 2003 ou Visual Studio 2005

Voir aussi

Partager via

filter, élément de browserCaps (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

Référence

Concepts

Autres ressources

Ressources supplémentaires