Элемент filter для элемента deviceFilters (схема параметров ASP.NET)
Предоставляет возможности фильтрации для класса MobileCapabilities.
<filter name="capability"
compare="capabilityName"
argument="argument" />
<filter name="capability"
type="className"
method="methodName" />
Атрибуты и элементы
В следующих разделах описаны атрибуты, дочерние и родительские элементы.
Атрибуты
Атрибут |
Описание |
|---|---|
argument |
Необязательный атрибут элемента String. Задает аргумент, с которым должна сравниваться возможность. Если определен атрибут compare, этот атрибут является обязательным. |
compare |
Необязательный атрибут String. Задает возможность обозревателя, оцениваемую фильтром сравнения. Возможность может быть любой встроенной возможностью или именем любого пользовательского фильтра сравнения. При задании фильтра сравнения этот атрибут является обязательным. |
method |
Необязательный атрибут String. Задает метод, который передает делегат фильтра. Используется при задании делегата фильтра. Если задан атрибут type, данный атрибут является обязательным, а задавать атрибуты compare и argument нельзя. |
name |
Обязательный атрибут типа String. Задает уникальное имя для идентификации фильтра. .gif "Примечание") Примечание
Фильтр, имеющий то же имя, что и ранее определенный фильтр (расположенный дальше в файле конфигурации или в иерархии файла конфигурации), заменяет прежний фильтр.
|
type |
Необязательный атрибут типа String. Задает тип класса, который передает делегат фильтра. |
Дочерние элементы
Отсутствует.
Родительские элементы
Элемент |
Описание |
|---|---|
configuration |
Обязательный корневой элемент любого файла конфигурации, используемого средой CLR и приложениями .NET Framework. |
system.web |
Указывает корневой элемент для параметров конфигурации ASP.NET в файле конфигурации. Содержит элементы конфигурации для настройки веб-приложений ASP.NET и управления поведением этих приложений. |
deviceFilters |
Задает устройство или класс устройств в системе ASP.NET MobileCapabilities на основании агента или обозревателя пользователя. |
Заметки
При создании веб-приложения, имеющего содержимое для конкретных устройств, необходимо добавить один или несколько фильтров в раздел deviceFilters файла конфигурации. Каждый фильтр задает некоторые условия, которым должны соответствовать целевые устройства.
Конфигурация фильтров устройств задает механизм оценки для двух типов фильтров: фильтров, основанных на сравнении, и делегатов фильтров. Этот синтаксис используется для обоих типов фильтров. Первый фильтр представляет собой фильтр, основанный на сравнении, а второй является делегатом фильтра. Подробное обсуждение создания фильтров в файле конфигурации см. в разделе Отрисовка для конкретного устройства.
В фильтрах устройств учитывается регистр. Фильтры с именами "isColor" и "IsColor" считаются разными.
Настройки по умолчанию
Следующий элемент deviceFilters по умолчанию не задается явно в файле конфигурации или в корневом файле Web.config, но является конфигурацией по умолчанию, возвращаемой приложением в .NET Framework версии 2.0.
<deviceFilters>
<filter name="isJPhone" compare="Type" argument="J-Phone"/>
<filter name="isHTML32" compare="PreferredRenderingType" argument="html32"/>
<filter name="isWML11" compare="PreferredRenderingType" argument="wml11"/>
<filter name="isCHTML10" compare="PreferredRenderingType" argument="chtml10"/>
<filter name="isGoAmerica" compare="Browser" argument="Go.Web"/>
<filter name="isMME" compare="Browser" argument="Microsoft Mobile Explorer"/>
<filter name="isMyPalm" compare="Browser" argument="MyPalm"/>
<filter name="isPocketIE" compare="Browser" argument="Pocket IE"/>
<filter name="isUP3x" compare="Type" argument="Phone.com 3.x Browser"/>
<filter name="isUP4x" compare="Type" argument="Phone.com 4.x Browser"/>
<filter name="isEricssonR380" compare="Type" argument="Ericsson R380"/>
<filter name="isNokia7110" compare="Type" argument="Nokia 7110"/>
<filter name="prefersGIF" compare="PreferredImageMIME" argument="image/gif"/>
<filter name="prefersWBMP" compare="PreferredImageMIME" argument="image/vnd.wap.wbmp"/>
<filter name="supportsColor" compare="IsColor" argument="true"/>
<filter name="supportsCookies" compare="Cookies" argument="true"/>
<filter name="supportsJavaScript" compare="Javascript" argument="true"/>
<filter name="supportsVoiceCalls" compare="CanInitiateVoiceCall" argument="true"/>
</deviceFilters>
Пример
В следующем примере выполняется настройка как фильтра сравнения, так и делегата фильтра. Первый фильтр представляет собой фильтр, основанный на сравнении, а второй является делегатом фильтра.
<deviceFilters>
<filter name="IsHtml"
compare="PreferredRendering"
argument="html32" />
<filter name="IsGPSEnabled"
type="Application1.CapabilityEvaluators1,Application1"
method="IsGPSEnabled" />
</deviceFilters>
Сведения об элементе
Обработчик раздела конфигурации |
|
Член конфигурации |
|
Настраиваемые расположения. |
Machine.config Файл Web.config корневого уровня Файл Web.config уровня приложения Файл Web.config уровня виртуального или физического каталога |
Требования |
IIS 5.0, IIS 5.1 или IIS 6.0 .NET Framework 1.1 или 2.0 Visual Studio 2003 или Visual Studio 2005 |
См. также
Задачи
Практическое руководство. Настройка отдельных каталогов с помощью параметров расположения
Пошаговое руководство. Отключение параметров конфигурации ASP.NET
Ссылки
Элемент system.web (схема параметров ASP.NET)
Элемент configuration (схема общих параметров)
Элемент mobileControls (схема параметров ASP.NET)
Основные понятия
Иерархия и наследование файла конфигурации ASP.NET
Настройка обеспечения безопасности ASP.NET
Другие ресурсы
Создание веб-страниц ASP.NET для мобильных устройств
Общие параметры конфигурации (ASP.NET)
Параметры конфигурации ASP.NET