Partager via


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

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

RemarqueRemarque

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_Browser existants au niveau des applications.Pour plus d'informations, consultez Schéma du fichier de définition de navigateur (élément browsers).

<browserCaps>
   <result />
   <use />
   [browser capability property assignments]
   <filter>...</filter>
</browserCaps>

Attributs et éléments

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

Attributs

Attribut

Description

userAgentCacheKeyLength

Attribut String facultatif.

Spécifie la longueur de la chaîne d'identification du navigateur à utiliser comme clé pour la mise en cache des fonctionnalités (objets Capabilities) du navigateur dans le cache interne. Pour plus d'informations sur les objets Capabilities de navigateur, consultez Schéma du fichier de définition de navigateur (élément browsers).

Cet attribut est une nouveauté de .NET Framework version 2.0.

La valeur par défaut est "64".

Éléments enfants

Élément

Description

filter

Élément facultatif.

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

result

Spécifie la classe dérivée de HttpCapabilitiesBase, utilisée pour stocker les résultats de l'analyse de la section browserCaps. Les fonctions sont stockées en tant que paires de chaînes clé/valeur pour chaque navigateur.

Cet élément est toujours appliqué dans la version 2.0 du .NET Framework.

use

Spécifie la chaîne de requête HTTP à utiliser pour analyser les informations sur les fonctionnalités du navigateur stockées dans les éléments filter et case.

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

Notes

L'élément browserCaps spécifie les paramètres des navigateurs pris en charge et les fonctionnalités de ces 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.

Les lignes se présentant sous la forme capsVariableName=regular expression sont des assignations. Utilisez la syntaxe %{capsVariableName} ou ${captureGroupName} dans les attributs match et à 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 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 l'objet HttpBrowserCapabilities hérité de la classe HttpCapabilitiesBase. La propriété Item est la propriété d'indexeur par défaut en C#.

Configuration par défaut

Dans le .NET Framework version 2.0, l'élément browserCaps par défaut limité suivant est configuré dans le fichier Web.config racine parce qu'il est déconseillé en faveur de l'utilisation de fichiers de définition de navigateur (.browser) pour spécifier les navigateurs pris en charge et leurs fonctionnalités. Pour plus d'informations, consultez Schéma du fichier de définition de navigateur (élément browsers).

<browserCaps userAgentCacheKeyLength="64">
   <result 
      type="System.Web.Mobile.MobileCapabilities, System.Web.Mobile, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a" 
   />
</browserCaps>

Dans les versions 1.0 et 1.1 du .NET Framework, les éléments browserCaps 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 montre comment analyser l'en-tête HTTP User-Agent pour n'importe quelle version de Microsoft Internet Explorer, pour autant 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 possibilité qu'elles offrent en termes de capture de sous-expressions, afin de déplacer directement des numéros de version de la chaîne User-Agent vers l'objet HttpBrowserCapabilities.

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>
 <system.web>
   <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>
 </system.web>
</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

Tâches

Comment : détecter les types de navigateurs et les fonctionnalités de navigateur dans les pages Web ASP.NET

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 browserCaps (Schéma des paramètres ASP.NET)

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

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

Schéma du fichier de définition de navigateur (élément browsers)

System.Configuration

System.Web.Configuration

HttpCapabilitiesSectionHandler

Browsers

Concepts

Fonctionnalités des contrôles serveur Web ASP.NET et du navigateur

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

Paramètres généraux de configuration (ASP.NET)

Paramètres de configuration ASP.NET

Administration de site Web ASP.NET

API de configuration ASP.NET