Элемент case для элемента filter для элемента browserCaps (схема параметров ASP.NET)
Обновлен: Ноябрь 2007
Разрешает прекратить поиск соответствий для шаблона после первого успешного сопоставления из нескольких альтернатив.
.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>
Сведения об элементе
Обработчик раздела конфигурации |
|
Элемент конфигурации |
|
Настраиваемые расположения |
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
Ссылки
Элемент filter для элемента browserCaps (схема параметров ASP.NET)
Элемент browserCaps (схема параметров ASP.NET)
Элемент system.web (схема параметров ASP.NET)
Элемент configuration (схема общих параметров)
Элемент result для элемента browserCaps (схема параметров ASP.NET)
Элемент use для элемента browserCaps (схема параметров ASP.NET)
Схема файла определения веб-обозревателя (элемент browsers)
HttpCapabilitiesSectionHandler
Другие ресурсы
Общие параметры конфигурации (ASP.NET)
Параметры конфигурации ASP.NET