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


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

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

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

71h1a04c.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)
        Элемент case для элемента filter для элемента browserCaps (схема параметров ASP.NET)

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

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

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

Атрибуты

Атрибут

Описание

match

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

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

with

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

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

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

Отсутствует.

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

Элемент

Описание

configuration

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

system.web

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

browserCaps

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

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

filter

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

Заметки

Элемент case разрешает прекратить поиск соответствий для шаблона после первого успешного сопоставления из нескольких альтернатив.

Все элементы filter и case могут содержать назначения и другие элементы filter и case. Отличие между группами case и filter заключается в том, что после оценки группы filter выполнение продолжается со следующего после группы оператора, в то время как после оценки группы case выполнение переходит в конец внешней группы.

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

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

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

Пример

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

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

В файле задаются пары "имя-значение" в виде операторов назначения аналогично файлам browscap.ini служб Microsoft Internet Information Services (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.1 или 1.0

Microsoft Visual Studio 2003 или Visual Studio 2005

См. также

Задачи

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

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

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

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

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

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

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

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

Ссылки

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

Элемент 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