Элемент browserCaps (схема параметров ASP.NET)

Статья
08/11/2011

Задает параметры поддерживаемых обозревателей и их возможности. Элемент browserCaps при необходимости может быть обновлен для определения будущих версий обозревателей и их возможностей.

Примечание
Использование элемента browserCaps из файла Web.config для определения обозревателей в .NET Framework версии 2.0 считается устаревшим, но пока поддерживается.Данные в этом элементе объединяются с информацией из файлов определения обозревателя (BROWSER), находящихся в папке "%SystemRoot%\Microsoft.NET\Framework\версия\CONFIG\Browsers" на уровне компьютера и в папках "App_Browser" на уровне существующего приложения.Дополнительные сведения см. в разделе Схема файла определения веб-обозревателя (элемент browsers).

Использование элемента browserCaps из файла Web.config для определения обозревателей в .NET Framework версии 2.0 считается устаревшим, но пока поддерживается.Данные в этом элементе объединяются с информацией из файлов определения обозревателя (BROWSER), находящихся в папке "%SystemRoot%\Microsoft.NET\Framework\версия\CONFIG\Browsers" на уровне компьютера и в папках "App_Browser" на уровне существующего приложения.Дополнительные сведения см. в разделе Схема файла определения веб-обозревателя (элемент browsers).

<browserCaps>
   <result />
   <use />
   [browser capability property assignments]
   <filter>...</filter>
</browserCaps>

Атрибуты и элементы

В следующих разделах описаны атрибуты, дочерние и родительские элементы.

Атрибуты

Атрибут	Описание
userAgentCacheKeyLength	Необязательный атрибут элемента String. Определяет длину строки идентификации обозревателя, используемой как ключ для кэширования объектов возможностей обозревателя во внутреннем кэше. Дополнительные сведения об объектах возможностей обозревателя см. в разделе Схема файла определения веб-обозревателя (элемент browsers). Этот атрибут не использовался до .NET Framework версии 2.0. По умолчанию используется значение "64".

userAgentCacheKeyLength

Необязательный атрибут элемента String.

Определяет длину строки идентификации обозревателя, используемой как ключ для кэширования объектов возможностей обозревателя во внутреннем кэше. Дополнительные сведения об объектах возможностей обозревателя см. в разделе Схема файла определения веб-обозревателя (элемент browsers).

Этот атрибут не использовался до .NET Framework версии 2.0.

По умолчанию используется значение "64".

Дочерние элементы

Элемент	Описание
filter	Необязательный элемент. Задает список строк поиска, позволяющий применить отдельные параметры к конкретным определениям браузера.
result	Задает производный от HttpCapabilitiesBase класс, используемый для хранения результатов синтаксического анализа раздела browserCaps. Возможности хранятся как строковые пары "ключ-значение" для каждого обозревателя. Этот элемент все еще применяется в .NET Framework версии 2.0.
use	Задает строку HTTP-запроса, которая используется для синтаксического анализа данных, хранимых в элементах filter и case.

filter

Необязательный элемент.

Задает список строк поиска, позволяющий применить отдельные параметры к конкретным определениям браузера.

result

Задает производный от HttpCapabilitiesBase класс, используемый для хранения результатов синтаксического анализа раздела browserCaps. Возможности хранятся как строковые пары "ключ-значение" для каждого обозревателя.

Этот элемент все еще применяется в .NET Framework версии 2.0.

use

Задает строку HTTP-запроса, которая используется для синтаксического анализа данных, хранимых в элементах filter и case.

Родительские элементы

Элемент	Описание
configuration	Задает обязательный корневой элемент любого файла конфигурации, который используется средой CLR и приложениями .NET Framework.
system.web	Задает корневой элемент для параметров конфигурации ASP.NET в файле конфигурации и содержит элементы конфигурации, предназначенные для настройки веб-приложений ASP.NET и управления их работой.

Заметки

Элемент browserCaps задает параметры поддерживаемых обозревателей и их возможности. Элемент browserCaps при необходимости может быть обновлен для определения будущих версий обозревателей и их возможностей.

Список допустимых свойств обозревателя см. в описании HttpBrowserCapabilities.

Строками формы capsVariableName=регулярное выражение являются операторы назначения. Синтаксис %{capsVariableName} или ${captureGroupName} используется в атрибутах match и в правой части операторы назначения.

Дополнительные сведения об использовании регулярных выражений см. в разделе Регулярные выражения в .NET Framework. Полностью заполненный раздел browserCaps и более полный пример данного синтаксиса см. в файле Machine.config, который был установлен вместе с .NET Framework.

К парам "имя-значение", полученным при помощи capsVariableName, можно обращаться через свойство Item объекта HttpBrowserCapabilities, наследуемого от класса HttpCapabilitiesBase. Свойство Item является свойством индексатора по умолчанию в C#.

Параметры по умолчанию

В платформе .NET Framework версии 2.0 следующий ограниченный элемент browserCaps задается по умолчанию в корневом файле Web.config, т.к. он не рекомендован к применению, и вместо него для задания поддерживаемых обозревателей и их возможностей следует использовать файлы определения обозревателя. Дополнительные сведения см. в разделе Схема файла определения веб-обозревателя (элемент browsers).

<browserCaps userAgentCacheKeyLength="64">
   <result 
      type="System.Web.Mobile.MobileCapabilities, System.Web.Mobile, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a" 
   />
</browserCaps>

В .NET Framework версий 1.0 и 1.1 элемент browserCaps, заданный по умолчанию в файле Machine.config, слишком большой для отображения в данном разделе справки. Для обновления данных обозревателя перейдите на веб-узел http://www.cyscape.com/browsercaps. При периодическом обновлении устройства данный раздел возможностей веб-обозревателя можно не использовать.

Пример

В следующем примере кода демонстрируется синтаксический анализ заголовка HTTP User-Agent для любой версии обозревателя Internet Explorer, если формат строки User-Agent остается почти без изменений.

В примере используются регулярные выражения .NET Framework и возможность регулярных выражений собирать части выражений для передачи номера версии напрямую из строки User-Agent в объект HttpBrowserCapabilities.

В файле задаются пары "имя-значение" в форме операторов назначения аналогично файлам browscap.ini служб Microsoft IIS. Например, строка "browser=IE" устанавливает значение "IE" для поля обозревателя.

<configuration>
 <system.web>
   <browserCaps>
      <result type="System.Web.HttpBrowserCapabilities, System.Web"/>
      <use var="HTTP_USER_AGENT"/>
      browser=Unknown
      version=0.0
      majorversion=0
      minorversion=0
      frames=false
      tables=false
      cookies=false
      backgroundsounds=false
      <filter>
    <case match="^Mozilla[^(]*\(compatible; MSIE 
       (?'ver'(?'major'\d+)(?'minor'\.\d+)(?'letters'\w*))
       (?'extra'.*)">
       browser=IE
       version=${ver}
       majorver=${major}
       minorver=${minor}
       <case match="^2\." with="%{version}">
          tables=true
          cookies=true
          backgroundsounds=true
          <case match="2\.5b" with="%{version}">
        beta=true
          </case>
       </case>
    </case>
      </filter>
   </browsercaps>
 </system.web>
</configuration>

Сведения об элементе

Обработчик раздела конфигурации	HttpCapabilitiesSectionHandler
Элемент конфигурации	Browsers
Настраиваемые расположения	Machine.config Файл Web.config корневого уровня Файл Web.config уровня приложения Файл Web.config уровня виртуального или физического каталога
Требования	Службы Microsoft IIS версии 5.0, 5.1 или 6.0 Платформа .NET Framework версии 2.0 (устаревшая), 1.1 или 1.0 Microsoft Visual Studio 2003 или Visual Studio 2005

См. также

Элемент browserCaps (схема параметров ASP.NET)

Атрибуты и элементы

Атрибуты

Дочерние элементы

Родительские элементы

Заметки

Параметры по умолчанию

Пример

Сведения об элементе

См. также

Задачи

Ссылки

Основные понятия

Другие ресурсы

Дополнительные ресурсы