Partager via


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

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

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

<use 
   var="server variable" 
   as="variableName"
/>

Attributs et éléments

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

Attributs

Attribut

Description

var

Attribut String facultatif.

Spécifie la variable serveur Microsoft Internet Information Services (IIS) qui est analysée pour extraire les informations relatives aux fonctionnalités du navigateur.

La valeur par défaut est "HTTP_USER_AGENT".

as

Attribut String facultatif.

Spécifie un nom qui peut être utilisé pour référencer la variable serveur dans les expressions régulières suivantes.

Éléments enfants

Aucun

Éléments parents

Élément

Description

configuration

É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. Cet élément peut être mis à jour, si nécessaire, pour spécifier de nouveaux navigateurs et leurs fonctionnalités.

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

Notes

L'élément use spécifie la chaîne de requête HTTP utilisée pour analyser les informations sur les fonctionnalités du navigateur stockées dans les éléments filter et case.

Configuration par défaut

Dans le .NET Framework version 2.0, l'élément use 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 fonctionnalités. 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 use par défaut configurés dans le fichier Machine.config sont trop nombreux pour être répertoriés ici. Pour obtenir des mises à jour des données du navigateur, consultez le site de cyScape, Inc. à 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 spécifier la variable serveur HTTP_USER_AGENT IIS en tant que source d'informations sur les fonctionnalités du navigateur.

<use var="HTTP_USER_AGENT">

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

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

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)

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