deviceFilters 的 filter 元素（ASP.NET 设置架构）
更新：2007 年 11 月
为 MobileCapabilities 类提供筛选功能。
configuration 元素（常规设置架构）
system.web 元素（ASP.NET 设置架构）
deviceFilters 元素（ASP.NET 设置架构）
deviceFilters 的 filter 元素（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 属性。 指定提供鉴别委托的类类型。 |
.gif "说明")
说明：子元素
无。
父元素
元素 |
说明 |
|---|---|
configuration |
公共语言运行库和 .NET Framework 应用程序所使用的每个配置文件中均需要的根元素。 |
system.web |
指定配置文件中 ASP.NET 配置设置的根元素。包含各种配置元素，这些配置元素配置 ASP.NET Web 应用程序并控制这些应用程序的行为方式。 |
deviceFilters |
根据用户代理或浏览器指定 ASP.NET MobileCapabilities 系统中的设备或设备类。 |
备注
在创建具有设备特定的内容的 Web 应用程序时，必须在配置文件的 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>
元素信息
配置节处理程序 |
|
配置成员 |
|
可配置的位置 |
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 |
请参见
任务
概念
参考
mobileControls 元素（ASP.NET 设置架构）