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

Статья
11/16/2008

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

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

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

<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. Задает уникальное имя для идентификации фильтра. Примечание. Фильтр, имеющий то же имя, что и ранее определенный фильтр (расположенный дальше в файле конфигурации или в иерархии файла конфигурации), заменяет прежний фильтр.
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>

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

Обработчик раздела конфигурации	System.Web.Mobile.DeviceFiltersSection
Элемент конфигурации	SystemWebSectionGroup.DeviceFilters DeviceSpecificChoice.Filter
Настраиваемые расположения	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

См. также

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

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

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

Атрибуты

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

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

Заметки

Настройки по умолчанию

Пример

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

См. также

Задачи

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

Ссылки

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

Дополнительные ресурсы