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

Указывает устройство или класс устройств в системе ASP.NET MobileCapabilities на основании агента или обозревателя пользователя. Разработчик страницы или приложения может использовать фильтр устройств для переопределения свойств элементов управления или для определения блоков содержимого или шаблонов для изменения макета и внешнего вида.

<deviceFilters>
     <filter.../>
</deviceFilters>

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

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

Атрибуты

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

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

Элемент

Описание

filter

Необязательный элемент.

Предоставляет возможности фильтрации для класса MobileCapabilities. Раздел <deviceFilters> может содержать один или несколько элементов фильтра.

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

Элемент

Описание

configuration

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

system.web

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

Заметки

Можно выбрать любой из двух типов фильтров устройств: фильтры сравнения или настраиваемые фильтры.

Для простых операций сравнения можно задать фильтр сравнения, указав имя возможности и значение, с которым он должен выполнять сравнение. Во время выполнения фильтру устройства присваивается значение true, если значение возможности совпадает с заданным значением. Сравнение логических свойств выполняется без учета регистра; и поэтому допускается как значение true, так и значение True. Сравнение других свойств выполняется с учетом регистра.

Для более сложных операций сравнения можно задать настраиваемый фильтр, указав класс и имя метода. Во время выполнения вызывается заданный метод, чтобы определить, присваивается ли фильтру устройства значение true.

Параметры по умолчанию

Следующий элемент <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="MyApplication.MyCapabilityEvaluators,MyApplication" 
    method="IsGPSEnabled" />
</deviceFilters>

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

Configuration Section Handler

System.Web.Mobile.DeviceFiltersSection

Configuration Member

SystemWebSectionGroup.DeviceFilters

Configurable Locations

Machine.config

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

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

Web.config.

Requirements

Службы 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 (схема общих параметров)

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

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

MobileCapabilities

System.Configuration

System.Web.Configuration

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

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

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

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

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

Using Device Filters

ASP.NET Mobile Web Pages

Создание веб-страниц ASP.NET для мобильных устройств

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

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

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

Файлы конфигурации ASP.NET

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