deviceFilters Element (ASP.NET Settings Schema)

Specifies a device or a device class in the ASP.NET MobileCapabilities system based on the user agent or browser. A device filter can be used by a page or application developer to override control properties or to define blocks of content or templates that change layout and appearance.

configuration Element (General Settings Schema)
  system.web Element (ASP.NET Settings Schema)
    deviceFilters Element (ASP.NET Settings Schema)


Attributes and Elements

The following sections describe attributes, child elements, and parent elements.



Child Elements




Optional element.

Provides filtering capability for the MobileCapabilities class. There can be one or more filter elements in the <deviceFilters> section.

Parent Elements




The required root element in every configuration file used by the common language runtime and the .NET Framework applications.


Specifies the root element for the ASP.NET configuration settings in a configuration file. Contains elements that configure ASP.NET Web applications and control how the applications behave.


You can select from two types of device filters: comparison evaluators or evaluator delegates.

For simple comparisons, you can specify a comparison-based filter by providing the name of a capability and a value to compare against. At run time, the device filter evaluates to true if the capability value and the supplied value are equal. Boolean property comparisons are case-insensitive; therefore, true and True are both valid. Other property comparisons are case-sensitive.

For more complex evaluation, you can specify an evaluator delegate-based filter by providing the class and method name of a method. At run time, the supplied method is called to determine whether the device filter evaluates to true.

Default Configuration

The following default <deviceFilters> element is not explicitly configured in the machine configuration file or in the root Web.config file, but is the default configuration returned by application in the .NET Framework version 2.0.

    <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=" 3.x Browser"/>
    <filter name="isUP4x" compare="Type" argument=" 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"/>


The following example configures both a comparison filter and an evaluator delegate filter.

  <filter name="IsHtml" 
    argument="html32" />
  <filter name="IsGPSEnabled" 
    method="IsGPSEnabled" />

Element Information

Configuration Section Handler


Configuration Member


Configurable Locations


Root level Web.config

Application-level Web.config



IIS 5.0, IIS 5.1, or IIS 6.0

.NET Framework 1.1, or 2.0

Visual Studio 2003, or Visual Studio 2005

See Also


How to: Configure Specific Directories Using Location Settings

How to: Lock ASP.NET Configuration Settings


system.web Element (ASP.NET Settings Schema)

configuration Element (General Settings Schema)

filter Element for deviceFilters (ASP.NET Settings Schema)

mobileControls Element (ASP.NET Settings Schema)





ASP.NET Configuration File Hierarchy and Inheritance

Securing ASP.NET Configuration

ASP.NET Configuration Scenarios

Other Resources

Using Device Filters

ASP.NET Mobile Web Pages

Creating ASP.NET Mobile Web Pages

General Configuration Settings (ASP.NET)

ASP.NET Configuration Settings

ASP.NET Web Site Administration

ASP.NET Configuration Files

ASP.NET Configuration API