Программа регистрации обозревателей для ASP.NET (Aspnet_regbrowsers.exe)
Обновлен: Ноябрь 2007
Программа регистрации обозревателей для ASP.NET анализирует и компилирует все общесистемные определения обозревателей в сборку и устанавливает сборку в глобальный кэш сборок. Данный инструмент использует файлы определения обозревателей (с расширением BROWSER) из подкаталога "Browsers" .NET Framework. Инструмент находится в каталоге %SystemRoot%\Microsoft.NET\Framework\version\.
В ASP.NET версии 1.1, файл Machine.config содержал раздел с именем <browserCaps>. Этот раздел содержал серию записей XML, определявших конфигурации для различных обозревателей на основе регулярного выражения. Для ASP.NET версии 2.0, новый файл с расширением BROWSER определяет параметры для различных обозревателей с помощью записей XML. Добавление информации о новом обозревателе выполняется добавлением нового файла с расширением BROWSER в папку %SystemRoot%\Microsoft.NET\Framework\version\CONFIG\Browsers вашей системы.
Так как приложение не считывает файл с расширением CONFIG каждый раз, когда ему требуется информация обозревателя, можно создать новый фал с расширением BROWSER и запустить Aspnet_regbrowsers.exe, чтобы добавить необходимые изменения в сборку. Это позволяет серверу немедленно получить доступ к новым данным обозревателя, чтобы не требовалось закрывать любые приложения для получения сведений. Приложение может обращаться к возможностям обозревателя с помощью свойства Browser текущего объекта HttpRequest.
Синтаксис
aspnet_regbrowsers.exe <options>
Параметры
Параметр |
Описание |
|---|---|
-? |
Отображает текст справки Aspnet_regbbrowsers.exe в командном окне. |
-i |
Создает сборку возможностей обозревателей времени выполнения и устанавливает ее в глобальный кэш сборок. |
-u |
Удаляет сборку возможностей обозревателей времени выполнения из глобального кэша сборок. |
Примечания
Файлы определения обозревателей могут быть общесистемными или привязанными к приложению, и разные типы хранятся в разных местах. Файлы определения обозревателей, привязанные к приложению, находятся в каталоге %SystemRoot%\Microsoft.NET\Framework\version\CONFIG\Browsers Этот каталог содержит файлы определения предопределенного обозревателя, поставляемого с соответствующей версией .NET Framework и любые файлы определения дополнительных обозревателей, скопированных туда из обновлений программного обеспечения или пакетов обновления. Не изменяйте файлы определения предопределенного обозревателя, которые поставляются с ASP.NET, потому что при установке пакетов обновления эти файлы могут обновляться, что приводит к потере изменений.
Файлы определения обозревателей, связанных с приложением, можно разместить в каталоге App_Browsers приложения. В обоих расположениях файлы определения обозревателей должны иметь расширение BROWSER. Использование программы регистрации обозревателей для ASP.NET не влияет на файлы определения обозревателей, связанных с приложением, хранящиеся в каталоге App_Browsers приложения.
Если файлы определения обозревателей на уровне системы изменяются, они автоматически вызывают обновление возможностей обозревателя для всех приложений. Необходимо запустить программу регистрации обозревателей для ASP.NET, чтобы обновить сборку возможностей обозревателя.
.gif "Примечание") Примечание. |
|---|
Программа регистрации обозревателей для ASP.NET выполняет компиляцию определений обозревателей в каталоге Browsers версии .NET Framework, соответствующей версии инструмента. Каждая версия .NET Framework имеет собственную копию инструмента. |
Программа регистрации обозревателей для ASP.NET анализирует и компилирует все общесистемные определения обозревателей в сборку и устанавливает сборку в глобальный кэш сборок. При наличии ошибок в общесистемных определениях обозревателей, программа реализации сообщит о них. Сборка возможностей обозревателя используется всеми веб-приложениями в системе. Обратите внимание, что можно также программно перекомпилировать общесистемные файлы определений обозревателя, используя класс BrowserCapabilitiesCodeGenerator.
Поведение
При запуске программы регистрации обозревателей для ASP.NET создается новая сборка, и эффект на все веб-приложения аналогичен эффекту изменения файла Machine.config: все запущенные веб-приложения запускаются повторно и службы IIS перезапускается. Программа регистрации также создает произвольный закрытый файл маркера, и создает файл ключа для подписи сборки, чтобы сборка могла быть установлена в глобальный кэш сборок. Файл ключа удаляется по окончании использования программы регистрации, оставляя только открытый ключ.
Во время выполнения данные из файла определения обозревателя добавляются в коллекцию известных обозревателей в объекте BrowserCapabilitiesFactory . При запросе, ASP.NET определяет обращающийся обозреватель по заголовку запроса и создает объект HttpBrowserCapabilities, который соответствует типу запрошенного обозревателя.
| Примечание. |
|---|
Использование элемента lt;browserCaps> из файла Web.config для определения обозревателей в .NET Framework версии 2.0 считается устаревшим, но пока поддерживается. Данные из этого элемента объединяются с данными из файлов определения обозревателя. |
В отличие от них, файлы определения обозревателя автоматически анализируются и компилируются по требованию при запуске приложения. Если в папке Browsers приложения произошли изменения, приложение автоматически перекомпилируется. Программа регистрации обозревателей для ASP.NET не влияет на файлы сведений об обозревателях уровня приложения.
Примеры
Для анализа и компиляции всех общесистемных определений обозревателей в сборку и устанавливает сборку в глобальный кэш сборок запустите Aspnet_regbrowsers.exe. В следующей команде выполняется создание и установка сборки:
C:\WINDOWS\Microsoft.NET\Framework\<versionNumber>\aspnet_regsql.exe -i
Также можно использовать программу регистрации обозревателей, чтобы удалить сборку определений обозревателя из глобального кэша сборок. Следующая команда выполняет удаление сборку определений обозревателя из глобального кэша сборок:
aspnet_regsql.exe -u
Чтобы получить справку по использованию программы регистрации обозревателей для ASP.NET, используйте следующую команду:
aspnet_regsql.exe -?
См. также
Задачи
Практическое руководство. Определение типов обозревателей на веб-страницах ASP.NET
Основные понятия
Серверные веб-элементы управления ASP.NET и возможности обозревателей
Защита файлов описания обозревателей