ASP - Файл Browscap.ini
В файле Browscap.ini можно объявить определение свойств для любого числа обозревателей. Можно также установить значения, которые используются по умолчанию, если обозреватель клиента не включен в список.
Для каждого определения обозревателя указывается HTTP-заголовок «Агент пользователя» и свойства и значения, связываемые с этим заголовком. Дополнительные сведения об HTTP-заголовке «Агент пользователя» приведены в спецификации HTTP, доступной по адресу http://www.w3.org.
Синтаксис
[; комментарии]
[ЗаголовокHTTPАгентаПользователя]
[parent = определениеОбозревателя]
[свойство1 = значение1]
...
[свойствоN = значениеN]
[Default Browser Capability Settings]
[свойство_по_умолчанию1 = значение_по_умолчанию1]
...
[свойство_по_умолчаниюN = значение_по_умолчаниюN]
Параметры
комментарии
Любая строка, начинающаяся с точки с запятой (;). Комментарии, которые игнорируются объектом BrowserType, могут появляться в любом месте файла Browscap.ini.
ЗаголовокHTTPАгентаПользователя
Указывает HTTP-заголовок «Агент пользователя» для связи с инструкцией установки значения свойства обозревателя, указанного в свойствоN. Файл Browscap.ini может содержать несколько определений обозревателя, каждое из которых начинается с уникального значения ЗаголовокHTTPАгентаПользователя.
Можно использовать символ звездочки (*) как знак подстановки в ЗаголовокHTTPАгентаПользователя для замены произвольного числа символов и символ (?) для замены одного символа.
Например для параметра ЗаголовокHTTPАгентаПользователя указано следующее значение:
[Mozilla/4.0 (compatible; MSIE 5.0;* Windows NT)]
Оно будет давать совпадение с каждым из следующих HTTP-заголовков:
[Mozilla/4.0 (compatible; MSIE 5.0; Windows NT)]
[Mozilla/4.0 (compatible; MSIE 5.0; AK; Windows NT)]
[Mozilla/4.0 (compatible; MSIE 5.0; SK; Windows NT)]
Примечание. Объект BrowserType сначала пытается найти точное совпадение HTTP-заголовка «Агент пользователя» и значения ЗаголовокHTTPАгентаПользователя. Если это не удается, он пытается найти совпадение с использованием знаков подстановки.
Если несколько определений обозревателя со знаками подстановки совпадает с заголовком HTTP, объект BrowserType возвращает свойства определения, наиболее близко совпадающего с заголовком «Агент пользователя». Ближайшее совпадение — это совпадение с заменой наименьшего числа символов.
определениеОбозревателя
Необязательный параметр, указывающий строку HTTP-заголовка «Агент пользователя» обозревателя, используемого как родительский обозреватель. Определение текущего обозревателя будет наследовать значения всех свойств определения родительского обозревателя. Это помогает определить свойства новой версии обозревателя, поскольку новые версии обычно сохраняют свойства предыдущих. Эти значения наследуемых свойств могут быть перезаписаны явным указанием нового значения свойства с помощью синтаксической конструкции свойствоN = значениеN.
свойствоN
Необязательный параметр, указывающий имя устанавливаемого параметра обозревателя. Оно должно начинаться с буквы и не может иметь больше 255 символов. Каждое определение обозревателя в файле Browscap.ini может содержать столько инструкций значений свойств, сколько нужно. Например, если приложение должно знать только поддерживает ли обозреватель VBScript, нужна только одна инструкция свойства для каждого определения обозревателя.
В приведенной ниже таблице перечислены некоторые возможные свойства:
| Свойство | Описание |
| ActiveXControls | Указывает поддержку обозревателем элементов управления ActiveX®. |
| Backgroundsounds | Указывает поддержку обозревателем воспроизведения звуковых файлов в фоновом режиме. |
| Beta | Указывает на то, что обозреватель является бета-версией. |
| Browser | Указывает имя обозревателя. |
| Cdf | Указывает поддержку обозревателем формата определения каналов для Webcasting. |
| Cookies | Указывает поддержку обозревателем модулей настройки. |
| Frames | Указывает поддержку обозревателем рамок. |
| Javaapplets | Указывает поддержку обозревателем минипрограмм Java. |
| Javascript | Указывает поддержку обозревателем JScript. |
| Platform | Указывает систему, под которой запущен обозреватель. |
| Tables | Указывает поддержку обозревателем таблиц. |
| Vbscript | Указывает поддержку обозревателем VBScript. |
| Version | Указывает номер версии обозревателя. |
значениеN
Необязательный параметр, указывающий значение свойстваN. По умолчанию это значение является строкой. Чтобы указать целое число, значение надо предварить символом #. Чтобы указать логическое значение, используйте TRUE или FALSE.
свойство_по_умолчаниюN
Необязательный параметр, указывающий имя свойства обозревателя, которому будет присвоено значение по умолчанию, если ни одно из значений ЗаголовокHTTPАгентаПользователя не совпадет со значением HTTP-заголовка, присланного обозревателем.
значение_по_умолчаниюN
Необязательный параметр, указывающий значение свойства_по_умолчаниюN. По умолчанию это значение является строкой. Чтобы указать целое число, значение надо предварить символом #. Чтобы указать логическое значение, используйте TRUE или FALSE.
Пример
В приведенном ниже примере тег «parent» позволяет второму определению обозревателя наследовать свойства первого, поэтому определение Microsoft® Internet Explorer 5.x наследует все свойства определения Microsoft® Internet Explorer 5.0 (например, frames=TRUE, tables=TRUE и cookies=TRUE). Внесением строки platform=WinNT добавляются сведения, относящиеся к конкретной операционной системе.
;;ie 5.0
[IE 5.0]
browser=IE
Version=5.0
majorver=#5
minorver=#0
frames=TRUE
tables=TRUE
cookies=TRUE
backgroundsounds=TRUE
vbscript=TRUE
javascript=TRUE
javaapplets=True
ActiveXControls=TRUE
Win16=False
beta=False
AK=False
SK=False
AOL=False
;;ie 5.x
[Mozilla/4.0 (compatible; MSIE 5.*; Windows NT)]
parent=IE 5.0
version=5.0
minorver=0
platform=WinNT
; Default Browser
[*]
browser=Default
frames=FALSE
tables=TRUE
cookies=FALSE
backgroundsounds=FALSE
vbscript=FALSE
javascript=FALSE