ASP.NET-Browserregistrierungstool (Aspnet_regbrowsers.exe)
Das ASP.NET-Browserregistrierungstool (Asnet_regbrowsers.exe) analysiert und kompiliert alle systemweiten Browserdefinitionen in eine Assembly und installiert die Assembly im globalen Assemblycache. Das Tool verwendet die Browserdefinitionsdateien (BROWSER-Dateien) aus dem .NET Framework-Unterverzeichnis Browsers.
Hinweis
Informationen zur Suche nach der richtigen Version von Asnet_regbrowsers.exe finden Sie weiter unten in diesem Thema unter Suchen der richtigen Version von Aspnet_regbrowsers.exe.
Syntax
aspnet_regbrowsers.exe <options>
Optionen
Option |
Beschreibung |
|---|---|
-? |
Zeigt den Hilfetext für Aspnet_regbbrowsers.exe im Befehlsfenster an. |
-i |
Erstellt die Assembly für die Laufzeitfunktionen des Browsers und installiert sie im globalen Assemblycache. |
-u |
Deinstalliert die Assembly für die Laufzeitfunktionen des Browsers aus dem globalen Assemblycache. |
Hinweise
Browserdefinitionsdateien können systemweit gültig oder anwendungsspezifisch sein, und jeder Typ befindet sich an einem anderen Speicherort. Systemweite Browserdefinitionsdateien werden im folgenden Pfad gespeichert:
%SystemRoot%\Microsoft.NET\Framework\Version\CONFIG\Browsers
Dieses Verzeichnis enthält vordefinierte Browserdefinitionsdateien, die mit der entsprechenden Version von .NET Framework geliefert werden, und ggf. weitere Browserdefinitionsdateien, die von Softwareupdates oder Service Packs in das Verzeichnis kopiert wurden. Sie können neue Browserdateien für Browserdefinitionen hinzufügen, die Sie global für Webanwendungen verfügbar machen möchten. Allerdings sollten die mit ASP.NET gelieferten vordefinierten Browserdefinitionsdateien nicht geändert werden, da diese Dateien möglicherweise durch Service Packs aktualisiert werden und Ihre Änderungen dabei überschrieben werden.
Anwendungsspezifische Browserdefinitionsdateien können im Verzeichnis App_Browsers der Anwendung gespeichert werden. Die Verwendung des ASP.NET-Browserregistrierungstools wirkt sich nicht auf anwendungsspezifische Browserdateien aus, die im Verzeichnis App_Browsers einer Anwendung gespeichert sind.
Wenn Browserdefinitionsdateien auf Systemebene geändert werden, verursachen die Änderungen nicht automatisch eine Aktualisierung der Browserfunktionen für alle Anwendungen. Sie müssen das ASP.NET-Browserregistrierungstool ausführen, um die Assembly für Browserfunktionen zu aktualisieren.
Hinweis
Das ASP.NET-Browserregistrierungstool kompiliert Browserdefinitionen im Browserverzeichnis unter %SystemRoot%, das dem Frameworkverzeichnis unter %WinDir% entspricht, von dem Sie das Tool ausführen.Die Version des Tools, das mit .NET Framework 2.0 bereitgestellt wird, aktualisiert die Browserdefinitionsassembly für Websites, für die als Ziel .NET Framework 2.0, .NET Framework 3.0 oder .NET Framework 3.5 festgelegt wurde. Die Version, die mit .NET Framework 4 bereitgestellt wird, aktualisiert die Browserdefinitionsassembly für Websites, für die als Ziel .NET Framework 4 festgelegt wurde.
Das ASP.NET-Browserregistrierungstool analysiert und kompiliert alle systemweiten Browserdefinitionen in eine Assembly und installiert die Assembly im globalen Assemblycache. Wenn in den systemweiten Browserdefinitionen Fehler auftreten, werden sie vom Tool gemeldet. Die Assembly für Browserfunktionen wird von allen Webanwendungen im System verwendet. Beachten Sie, dass Sie mit der BrowserCapabilitiesCodeGenerator-Klasse systemweite Browserdefinitionsdateien auch programmgesteuert erneut kompilieren können.
Verhalten
Bei der Ausführung des ASP.NET-Browserregistrierungstools wird eine neue Assembly erstellt, und die Auswirkungen auf alle Webanwendungen sind dieselben wie bei einer Änderung der Datei Machine.config: Alle ausgeführten Webanwendungen werden wiederverwendet, und Microsoft Internetinformationsdienste (IIS) wird neu gestartet. Das Tool generiert außerdem eine nach dem Zufallsprinzip erzeugte Privattokendatei und erstellt eine Schlüsseldatei zum Signieren der Assembly, sodass die Assembly im globalen Assemblycache installiert werden kann. Die Schlüsseldatei wird entfernt, wenn das Tool beendet wird, und nur der öffentliche Schlüssel bleibt erhalten.
Zur Laufzeit werden Browserdefinitionsinformationen in einem BrowserCapabilitiesFactory-Objekt zu einer Auflistung von bekannten Browsern zusammengeführt. Wenn eine Anforderung erfolgt, identifiziert ASP.NET anhand des Anforderungsheaders den anfordernden Browser und kompiliert ein HttpBrowserCapabilities-Objekt, das dem Typ des angeforderten Browsers entspricht.
Hinweis
.NET Framework 1.1 speichert Browserdefinitionen im browserCaps-Element in der Datei Web.config.Dieser Abschnitt ist in .NET Framework, Version 2.0, veraltet, wird aber immer noch unterstützt.Die Daten in diesem Element werden mit den Informationen aus den Browserdefinitionsdateien zusammengeführt.
Browserdefinitionsdateien auf Anwendungsebene werden analysiert und mit den anderen Anwendungsquelldateien kompiliert. Für ein Websiteprojekt geschieht Kompilierung bei Bedarf, wenn die Anwendung gestartet wird, und die Anwendung wird automatisch neu kompiliert, wenn alle Änderungen am Browserverzeichnis der Anwendung vorgenommen werden. Das ASP.NET-Browserregistrierungstool hat keine Auswirkungen auf Browserinformationsdateien auf Anwendungsebene.
Beispiele
Um alle systemweiten Browserdefinitionen zu analysieren, in eine Assembly zu kompilieren und die Assembly im globalen Assemblycache zu installieren, führen Sie den folgenden Befehl aus:
aspnet_ regbrowsers.exe -i
Sie können auch mit dem Tool die Browserdefinitionsassembly aus dem globalen Assemblycache entfernen. Der folgende Befehl entfernt die Browserdefinitionsassembly aus dem globalen Assemblycache:
aspnet_ regbrowsers.exe -u
Um Hilfe zur Verwendung des ASP.NET-Browserregistrierungstools zu erhalten, verwenden Sie den folgenden Befehl:
aspnet_ regbrowsers.exe -?
Suchen der richtigen Version von Aspnet_regbrowsers.exe
Aspnet_regbrowsers.exe ist im Verzeichnis von Microsoft.NET Framework installiert. Wenn auf dem Computer mehrere .NET Framework-Versionen parallel ausgeführt werden, werden unter Umständen mehrere Versionen des Tools installiert. In der folgenden Tabelle sind die Orte aufgeführt, an denen das Tool für andere Versionen von .NET Framework installiert ist.
Version von .NET Framework |
Ort der Datei Aspnet_regbrowsers.exe |
|---|---|
.NET Framework, Version 2.0, Version 3.0 und Version 3.5 (32-Bit-Systeme) |
%windir%\Microsoft.NET\Framework\v2.0.50727 |
.NET Framework, Version 2.0, Version 3.0 und Version 3.5 (64-Bit-Systeme) |
%windir%\Microsoft.NET\Framework64\v2.0.50727 |
.NET Framework, Version 4 (32-Bit-Systeme) |
%windir%\Microsoft.NET\Framework\v4.0.30319 |
.NET Framework, Version 4 (64-Bit-Systeme) |
%windir%\Microsoft.NET\Framework64\v4.0.30319 |
Siehe auch
Aufgaben
Gewusst wie: Erkennen von Browsertypen und Browserfunktionen auf ASP.NET-Webseiten
Referenz
Schema der Browserdefinitionsdatei (browsers-Element)