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

[Cette documentation constitue un aperçu et pourra faire l'objet de modifications dans les versions ultérieures. Des rubriques vierges sont incluses en tant qu'espaces réservés.]

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.

<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

Éléments enfants

Éléments parents

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

Voir aussi

Tâches

How to: Detect Browser Types in ASP.NET Web Pages

How to: Configure Specific Folders Using Location Settings

How to: Lock ASP.NET Configuration Settings

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

ASP.NET Server Controls and Browser Capabilities

ASP.NET Configuration File Hierarchy

Securing Configuration

Configuration Inheritance

Autres ressources

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

Paramètres de configuration ASP.NET

Configuring ASP.NET Applications

ASP.NET Configuration API