Программа регистрации обозревателей для ASP.NET (Aspnet_regbrowsers.exe)
Программа регистрации обозревателей для ASP.NET (Asnet_regbrowsers.exe) анализирует и компилирует все общесистемные определения браузеров в сборку и устанавливает сборку в глобальный кэш сборок. Данный инструмент использует файлы определения обозревателей (с расширением BROWSER) из подкаталога "Browsers" .NET Framework.
Примечание
Дополнительные сведения о том, как найти правильную версию программы Asnet_regbrowsers.exe см. в подразделе Поиск правильной версии Aspnet_regbrowsers.exe далее в этом разделе.
Синтаксис
aspnet_regbrowsers.exe <options>
Параметры
Параметр |
Описание |
|---|---|
-? |
Отображает текст справки Aspnet_regbbrowsers.exe в командном окне. |
-i |
Создает сборку возможностей обозревателей времени выполнения и устанавливает ее в глобальный кэш сборок. |
-u |
Удаляет сборку возможностей обозревателей времени выполнения из глобального кэша сборок. |
Примечания
Файлы определения обозревателей могут быть общесистемными или привязанными к приложению, и разные типы хранятся в разных местах. Общесистемные файлы определений браузеров хранятся по следующему пути.
%SystemRoot%\Microsoft.NET\Framework\версия\CONFIG\Browsers
Этот каталог содержит файлы определения предопределенного браузера, поставляемого с соответствующей версией .NET Framework и любые файлы определения дополнительных браузеров, скопированных туда из обновлений программного обеспечения или пакетов обновления. Можно добавлять новые файлы браузеров для определений браузеров, которые должны быть доступны веб-приложениям глобально. Не изменяйте файлы определения предопределенного браузера, которые поставляются с ASP.NET, потому что при установке пакетов обновления эти файлы могут обновляться, что приводит к потере изменений.
Файлы определения обозревателей, связанных с приложением, можно разместить в каталоге App_Browsers приложения. Использование программы регистрации обозревателей для ASP.NET не влияет на файлы определения обозревателей, связанных с приложением, хранящиеся в каталоге App_Browsers приложения.
Если файлы определения обозревателей на уровне системы изменяются, они автоматически вызывают обновление возможностей обозревателя для всех приложений. Необходимо запустить программу регистрации обозревателей для ASP.NET, чтобы обновить сборку возможностей обозревателя.
Примечание
Программа регистрации обозревателей для ASP.NET выполняет компиляцию определений браузеров в каталоге "Обозреватели", расположенного в узле %SystemRoot%, соответствующем каталогу "Платформа" в каталоге %WinDir%, из которого выполняется программа.Версия программы, включенная в .NET Framework 2.0, обновляет сборку определений браузеров для веб-сайтов, предназначенных для .NET Framework 2.0, .NET Framework 3.0 или .NET Framework 3.5. Версия, включенная в .NET Framework 4, обновляет сборку определений браузеров для веб-сайтов, предназначенных для .NET Framework 4.
Программа регистрации обозревателей для ASP.NET анализирует и компилирует все общесистемные определения обозревателей в сборку и устанавливает сборку в глобальный кэш сборок. При наличии ошибок в общесистемных определениях обозревателей, программа реализации сообщит о них. Сборка возможностей обозревателя используется всеми веб-приложениями в системе. Обратите внимание, что можно также программно перекомпилировать общесистемные файлы определений обозревателя, используя класс BrowserCapabilitiesCodeGenerator.
Поведение
При запуске программы регистрации обозревателей для ASP.NET создается новая сборка, и эффект на все веб-приложения аналогичен эффекту изменения файла Machine.config: все запущенные веб-приложения запускаются повторно и службы IIS перезапускается. Программа регистрации также создает произвольный закрытый файл маркера, и создает файл ключа для подписи сборки, чтобы сборка могла быть установлена в глобальный кэш сборок. Файл ключа удаляется по окончании использования программы регистрации, оставляя только открытый ключ.
Во время выполнения сведения определения браузера добавляются в коллекцию известных браузеров в объекте BrowserCapabilitiesFactory. При запросе, ASP.NET определяет обращающийся обозреватель по заголовку запроса и создает объект HttpBrowserCapabilities, который соответствует типу запрошенного обозревателя.
Примечание
Платформа .NET Framework 1.1 содержит определения браузеров в элементе browserCaps файла Web.config.Этот раздел объявлен устаревшим в платформе .NET Framework версии 2.0, но продолжает поддерживаться.Данные из этого элемента объединяются с данными из файлов определения обозревателя.
Файлы определений браузеров на уровне приложений анализируются и компилируются вместе с другими исходными файлами приложения. Для проекта веб-сайта компиляция происходит по требованию при запуске приложения. Приложение автоматически компилируется повторно при внесении любых изменений в каталог "Обозреватели" приложения. Программа регистрации обозревателей для ASP.NET не влияет на файлы сведений об обозревателях уровня приложения.
Примеры
Для анализа и компиляции всех общесистемных определений браузеров в сборку и ее установки в глобальный кэш сборок выполните следующую команду.
aspnet_ regbrowsers.exe -i
Также можно использовать программу регистрации обозревателей, чтобы удалить сборку определений обозревателя из глобального кэша сборок. Следующая команда выполняет удаление сборку определений обозревателя из глобального кэша сборок:
aspnet_ regbrowsers.exe -u
Чтобы получить справку по использованию программы регистрации обозревателей для ASP.NET, используйте следующую команду:
aspnet_ regbrowsers.exe -?
Поиск правильной версии Aspnet_regbrowsers.exe
Aspnet_regbrowsers.exe устанавливается в каталог Microsoft.NET Framework. Если на компьютере одновременно работает несколько версий .NET Framework, можно установить несколько версий программы. В следующей таблице перечислены расположения, в которых устанавливается эта программа для различных версий .NET Framework.
Версия платформы .NET Framework |
Расположение файла Aspnet_regbrowsers.exe |
|---|---|
Платформа .NET Framework версии 2.0, версии 3.0 и версии 3.5 (32-разрядные системы) |
%windir%\Microsoft.NET\Framework\v2.0.50727 |
Платформа .NET Framework версии 2.0, версии 3.0 и версии 3.5 (64-разрядные системы) |
%windir%\Microsoft.NET\Framework64\v2.0.50727 |
Платформа .NET Framework версии 4 (32-разрядные системы) |
%windir%\Microsoft.NET\Framework\v4.0.30319 |
Платформа .NET Framework версии 4 (64-разрядные системы) |
%windir%\Microsoft.NET\Framework64\v4.0.30319 |
См. также
Задачи
Практическое руководство. Определение типов и возможностей браузеров на веб-страницах ASP.NET
Ссылки
Схема файла определения веб-обозревателя (элемент browsers)
Основные понятия
Серверные веб-элементы управления ASP.NET и возможности обозревателей