ASP.NET Browser Registration Tool, outil (Aspnet_regbrowsers.exe)
Mise à jour : novembre 2007
L'outil ASP.NET Browser Registration Tool analyse et compile des définitions de navigateur à l'échelle du système dans un assembly et installe l'assembly dans le Global Assembly Cache. L'outil utilise les fichiers de définition de navigateur (fichiers .BROWSER) du sous-répertoire de navigateurs .NET Framework. L'outil se trouve dans le répertoire %SystemRoot%\Microsoft.NET\Framework\version\.
Dans la version 1.1 d'ASP.NET, le fichier Machine.config contenait une section appelée <browserCaps>. Cette section contenait une série d'entrées XML qui définissait les configurations pour différents navigateurs selon une expression régulière. Pour la version 2.0 d'ASP.NET, un nouveau fichier .BROWSER définit les paramètres d'un navigateur particulier à l'aide d'entrées XML. Vous ajoutez des informations sur un nouveau navigateur en ajoutant un nouveau fichier .BROWSER dans le dossier se trouvant dans le répertoire %SystemRoot%\Microsoft.NET\Framework\version\CONFIG\Browsers de votre système.
Puisqu'une application ne lit pas un fichier .config chaque fois qu'elle a besoin des informations liées au navigateur, vous pouvez créer un fichier .BROWSER et exécuter Aspnet_regbrowsers.exe pour ajouter les modifications requises à l'assembly. Cela permet au serveur d'accéder immédiatement aux nouvelles informations du navigateur, pour que vous n'ayez pas à fermer toutes vos applications pour recueillir les informations. Une application peut accéder aux fonctionnalités de navigateur par le biais de la propriété Browser de la HttpRequest en cours.
Syntaxe
aspnet_regbrowsers.exe <options>
Options
Option |
Description |
|---|---|
-? |
Affiche le texte d'aide du fichier Aspnet_regbbrowsers.exe dans la fenêtre de commande. |
-i |
Crée l'assembly des fonctionnalités de navigateur au moment de l'exécution et l'installe dans le Global Assembly Cache. |
-u |
Désinstalle l'assembly des fonctionnalités de navigateur au moment de l'exécution du Global Assembly Cache. |
Notes
Les fichiers de définition de navigateur peuvent être soit à l'échelle du système soit spécifiques à l'application, et chaque type est stocké dans un emplacement différent. Les fichiers de définition de navigateur à l'échelle du système sont stockés dans le répertoire %SystemRoot%\Microsoft.NET\Framework\version\CONFIG\Browsers. Ce répertoire contient des fichiers de définition de navigateur prédéfinis qui ont été fournis avec la version correspondante du .NET Framework et tous les fichiers de définition de navigateur supplémentaires qui y sont copiés à partir de mises à jour de logiciel ou de Service Packs. Ne modifiez pas les fichiers de définition de navigateur prédéfinis fournis avec ASP.NET, car les Service Packs peuvent mettre à jour ces fichiers et remplacer vos modifications.
Les fichiers de définition de navigateur spécifiques de l'application peuvent être placés dans le répertoire App_Browsers de l'application. Dans les deux emplacements, les fichiers de définition de navigateur doivent avoir une extension de nom de fichier .BROWSER. L'utilisation de l'outil ASP.NET Browser Registration Tool n'a aucun effet sur les fichiers de définition de navigateur spécifiques à l'application stockés dans le répertoire App_Browsers d'une application.
Lorsque les fichiers de définition de navigateur au niveau du système sont modifiés, ils n'entraînent pas automatiquement une mise à jour de fonctionnalités de navigateur pour toutes les applications. Vous devez exécuter l'Outil ASP.NET Browser Registration Tool pour mettre à jour l'assembly de fonctionnalités de navigateur.
.gif "Remarque") Remarque : |
|---|
Cet outil compile des définitions de navigateur dans le répertoire Browsers de la version du .NET Framework qui correspond à la version de l'outil. Chaque version du .NET Framework possède sa propre copie de l'outil. |
L'outil ASP.NET Browser Registration Tool analyse et compile des définitions de navigateur à l'échelle du système dans un assembly et installe l'assembly dans le Global Assembly Cache. S'il y a des erreurs dans les définitions de navigateur à l'échelle du système, l'outil signale ces erreurs. L'assembly de fonctionnalités de navigateur est utilisé par toutes les applications Web sur le système. Notez que vous pouvez également recompiler des fichiers de définition de navigateur par programme à l'échelle du système à l'aide de la classe BrowserCapabilitiesCodeGenerator.
Comportement
Lorsque l'outil ASP.NET Browser Registration Tool s'exécute, un assembly est créé et l'effet sur toutes les applications Web est le même que si le fichier Machine.config avait été changé : toutes les applications Web en cours d'exécution sont recyclées et Microsoft Internet Information Services (IIS) redémarré. L'outil génère également un fichier jeton privé aléatoire et crée un fichier de clé pour signer l'assembly afin que ce dernier puisse être installé dans le Global Assembly Cache. Le fichier de clé est supprimé lorsque l'outil est fini, seule la clé publique est laissée.
Au moment de l'exécution, les informations du fichier de définition de navigateur sont fusionnées dans une collection de navigateurs connus dans un objet BrowserCapabilitiesFactory. Lorsqu'une demande est faite, ASP.NET identifie le navigateur demandeur à l'en-tête de la demande et compile un objet HttpBrowserCapabilities qui correspond au type du navigateur demandé.
| Remarque : |
|---|
L'utilisation de l'élément <browserCaps> dans le fichier Web.config pour définir des navigateurs est désapprouvée dans la version 2.0 du .NET Framework, mais elle reste prise en charge. Les données dans cet élément sont fusionnées avec les informations des fichiers de définition de navigateur. |
Par contraste, les fichiers de définition de navigateur au niveau de l'application sont analysés et compilés automatiquement à la demande au redémarrage de l'application. Si des modifications sont apportées au répertoire Browsers de l'application, l'application est recompilée automatiquement. L'outil ASP.NET Browser Registration Tool n'a aucun effet sur les fichiers d'informations du navigateur au niveau de l'application.
Exemples
Pour analyser et compiler des définitions de navigateur à l'échelle du système dans un assembly et installer l'assembly dans le Global Assembly Cache, exécutez Aspnet_regbrowsers.exe. La commande suivante crée et installe l'assembly :
C:\WINDOWS\Microsoft.NET\Framework\<versionNumber>\aspnet_regsql.exe -i
Vous pouvez également utiliser l'outil pour supprimer l'assembly de la définition du navigateur du Global Assembly Cache. La commande suivante supprime l'assembly des définitions du navigateur du Global Assembly Cache :
aspnet_regsql.exe -u
Pour obtenir de d'aide sur l'utilisation de l'outil ASP.NET Browser Registration Tool, utilisez la commande suivante :
aspnet_regsql.exe -?
Voir aussi
Tâches
Comment : détecter les types de navigateurs dans les pages Web ASP.NET
Concepts
Fonctionnalités des contrôles serveur Web ASP.NET et du navigateur
Sécurisation de fichiers de définitions de navigateur
Référence
Schéma du fichier de définition de navigateur (élément browsers)