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

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

  • Статья

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

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

Элемент configuration (схема общих параметров)
  Элемент system.web (схема параметров ASP.NET)
    Элемент deviceFilters (схема параметров ASP.NET)

<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, 5.1 или 6.0

Платформы .NET Framework версии 1.1 или 2.0

Visual Studio 2003 или Visual Studio 2005

См. также

Задачи

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

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

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

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

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

Сценарии конфигурации 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)

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

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

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

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