use, élément de browserCaps (Schéma des paramètres ASP.NET)
Mise à jour : novembre 2007
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.
.gif "Remarque") Remarque : |
|---|
L'utilisation de l'élément browserCaps dans le fichier Web.config pour définir des navigateurs est désapprouvé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). |
configuration, élément (Schéma des paramètres généraux)
system.web, élément (Schéma des paramètres ASP.NET)
browserCaps, élément (Schéma des paramètres ASP.NET)
use, élément de browserCaps (Schéma des paramètres ASP.NET)
<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ésapprouvé 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 des mises à jour des données du navigateur, rendez-vous sur 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 |
|
Membre de configuration |
|
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ésapprouvée), 1.1 ou 1.0 Microsoft Visual Studio 2003 ou Visual Studio 2005 |
Voir aussi
Tâches
Comment : détecter les types de navigateurs 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
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
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)
HttpCapabilitiesSectionHandler
Autres ressources
Paramètres généraux de configuration (ASP.NET)
Paramètres de configuration ASP.NET