Поделиться через

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

  • Статья

Обновлен: Ноябрь 2007

Данный элемент определяет список строк поиска, который позволяет применять отдельные параметры для конкретных определений обозревателя..

6w27hyx4.alert_note(ru-ru,VS.90).gifПримечание.

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

Элемент configuration (схема общих параметров)
  Элемент system.web (схема параметров ASP.NET)
    Элемент browserCaps (схема параметров ASP.NET)
      Элемент filter для элемента browserCaps (схема параметров ASP.NET)

<filter> 
   [assignments, filter elements and case elements]
<filter>
<filter 
   match="[regular expression]" 
   with="[regular expression]" >
   [browser capability assignments, filter elements, case elements]
</filter>
<filter>
   <case>...</case>
</filter>

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

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

Атрибуты

Атрибут

Описание

match

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

Задает регулярное выражение .NET Framework, проверяемое на соответствие атрибуту with. Если этот атрибут отсутствует, сопоставление считается успешным.

with

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

Задает регулярное выражение .NET Framework или строку для поиска. Если выражение или строка отсутствуют, используется строка, указанная в элементе use.

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

Элемент

Описание

case

Разрешает прекращение поиска соответствий после обнаружения первого совпадения при выборе из нескольких альтернативных вариантов.

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

Элемент

Описание

configuration

Задает обязательный корневой элемент любого файла конфигурации, используемого средой CLR и приложениями .NET Framework.

system.web

Задает корневой элемент для параметров конфигурации ASP.NET в файле конфигурации и содержит элементы конфигурации, предназначенные для настройки веб-приложений ASP.NET и управления их работой.

browserCaps

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

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

Заметки

Элемент browserCapsопределяет список строк поиска, которые позволяют применять отдельные параметры для конкретных определений обозревателя. Правила из этого списка применяются последовательно. Вычисляется первый совпавший дочерний элемент case, а оставшиеся дочерние элементы case пропускаются.

Конфигурация по умолчанию

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

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

Пример

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

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

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

<configuration>
   <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>
</configuration>

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

Обработчик раздела конфигурации

HttpCapabilitiesSectionHandler

Член конфигурации

Browsers

Настраиваемые расположения

Machine.config

Файл Web.config корневого уровня

Файл Web.config уровня приложения

Файл Web.config уровня виртуального или физического каталога

Требования

Службы Microsoft IIS версии 5.0, 5.1 или 6.0

.NET Framework версии 2.0 (устаревшая), 1.0 или 1.1

Microsoft Visual Studio 2003 или Visual Studio 2005

См. также

Задачи

Практическое руководство. Определение типов обозревателей на веб-страницах ASP.NET

Практическое руководство. Настройка отдельных каталогов с помощью параметров расположения

Пошаговое руководство. Отключение параметров конфигурации ASP.NET

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

Серверные веб-элементы управления ASP.NET и возможности обозревателей

Иерархия и наследование файла конфигурации ASP.NET

Настройка обеспечения безопасности ASP.NET

Сценарии конфигурации ASP.NET

Ссылки

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

Элемент case для элемента filter для элемента browserCaps (схема параметров ASP.NET)

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

Элемент configuration (схема общих параметров)

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

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

Схема файла определения веб-обозревателя (элемент browsers)

System.Configuration

System.Web.Configuration

HttpCapabilitiesSectionHandler

Browsers

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

Общие параметры конфигурации (ASP.NET)

Параметры конфигурации ASP.NET

Администрирование веб-узлов ASP.NET

Конфигурационный интерфейс API ASP.NET