<browserCaps>, élément

Article
04/11/2008

Contrôle les paramètres du composant des fonctionnalités du navigateur. L'élément <browserCaps> peut être déclaré aux niveaux de l'ordinateur, du site, de l'application et du sous-répertoire. L'élément <browserCaps> peut être mis à jour selon les besoins de façon à détecter des navigateurs à venir et leurs fonctionnalités.

Pour connaître la liste des propriétés valides pour les navigateurs, consultez la classe HttpBrowserCapabilities.

<configuration>
<system.web>
** <browserCaps>**

<browserCaps>
   <result type="class"/>   <use var="HTTP_USER_AGENT"/>        browser=Unknown
        version=0.0
        majorver=0
        minorver=0
        frames=false
        tables=false
      <filter>         <case match="Windows 98|Win98">
            platform=Win98
         </case>      <case match="Windows NT|WinNT">
         platform=WinNT
      </case>   </filter>   <filter match="Unknown" with="%(browser)">
      <filter match="Win95" with="%(platform)">
      </filter>   </filter></browserCaps>

Sous-balises

Sous-balise	Description
<use>	Spécifie les variables serveur utilisées lors de l'évaluation de <filter>, <case> et des assignations contenues dans la section.
<filter>	Évalue le premier élément <case> enfant qui correspond ; les autres sont ignorés.
<result>	Spécifie la classe dérivée HttpCapabilitiesBase utilisée pour contenir les paires de chaînes clé-valeur résultant de l'analyse de cette section (par exemple, `browser`, `version` et `majorver` dans le bloc de syntaxe ci-dessus). Cette chaîne est utilisée au moment de l'exécution pour créer le type de retour.

Notes

Les lignes se présentant sous la forme capsVariableName=expression régulière sont des assignations. Utilisez la syntaxe %{capsVariableName} ou ${captureGroupName} dans les attributs match à droite des assignations. Pour plus d'informations sur l'utilisation des expressions régulières, consultez Expressions régulières du .NET Framework. Pour avoir l'ensemble de la section <browserCaps>, avec un exemple plus complet de cette syntaxe, consultez le fichier Machine.config installé avec le .NET Framework.

Les paires nom/valeur capturées par capsVariableName sont accessibles via la propriété Item de la classe HttpBrowserCapabilities héritée de HttpCapabilitiesBase. La propriété Item est la propriété d'indexeur par défaut en C#.

Exemple

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

L'exemple utilise des Expressions régulières du .NET Framework et exploite la possibilité qu'ont les expressions régulières de capturer des sous-expressions afin de déplacer des numéros de version directement de la chaîne User-Agent vers l'objet browsercaps.

Le fichier spécifie les paires nom/valeur sous la forme d'instructions d'assignation, à la manière des fichiers browscap.ini des services IIS (Internet Information Services). Par exemple, la ligne « browser=IE » affecte la valeur du champ browser à la 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>

Configuration requise

Contenu dans : <system.web>

Plate-forme Web : IIS 5.0, IIS 5.1, IIS 6.0

Fichier de configuration : Machine.config, Web.config

Gestionnaire de sections de configuration : System.Web.Configuration.HttpCapabilitiesSectionHandler

Voir aussi

Configuration ASP.NET | Schéma des paramètres ASP.NET

Partager via