deviceFilters 的 filter 元素（ASP.NET 设置架构）

项目
05/28/2012

[本文档仅供预览，在以后的发行版中可能会发生更改。包含的空白主题用作占位符。]

为 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 特性。指定应该用于标识筛选器的唯一名称。 Note 与以前定义的筛选器同名的筛选器是指在配置文件的后面或配置文件层次结构的后面定义的筛选器，它将重写以前定义的筛选器。
type	可选的 String 特性。指定提供计算委托的类类型。

子元素

无。

父元素

元素	说明
configuration	公共语言运行时和 .NET Framework 应用程序所使用的每个配置文件中均需要的根元素。
system.web	指定配置文件中 ASP.NET 配置设置的根元素。包含各种配置元素，这些配置元素配置 ASP.NET Web 应用程序并控制这些应用程序的行为方式。
deviceFilters	根据用户代理或浏览器指定 ASP.NET MobileCapabilities 系统中的设备或设备类。

备注

在创建具有设备特定的内容的 Web 应用程序时，必须在配置文件的 deviceFilters 节内添加一个或多个筛选器。每一筛选器都指定目标设备应与之相符的某些条件。

设备筛选器配置为以下两种类型的筛选器提供计算机制：基于比较的筛选器和基于计算委托的筛选器。语法指定了这两种筛选器类型。第一种筛选器表示基于比较的筛选器，第二种筛选器表示基于计算委托的筛选器。有关在配置文件中创建筛选器的详细论述，请参见Device-Specific Rendering。

设备筛选器区分大小写。名为“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

请参见

通过

deviceFilters 的 filter 元素（ASP.NET 设置架构）

特性和元素

特性

子元素

父元素

备注

默认配置

示例

元素信息

请参见

任务

参考

概念

其他资源

其他资源