deviceFilters 元素(ASP.NET 设置架构)

更新:2007 年 11 月

根据用户代理或浏览器指定 ASP.NET MobileCapabilities 系统中的设备或设备类。页或应用程序开发人员可以使用设备筛选器来重写控件属性。设备筛选器还可用于定义能够更改布局和外观的内容块或模板块。

configuration 元素(常规设置架构)
  system.web 元素(ASP.NET 设置架构)
    deviceFilters 元素(ASP.NET 设置架构)

<deviceFilters>
     <filter.../>
</deviceFilters>

属性和元素

下面几部分描述了属性、子元素和父元素。

属性

无。

子元素

元素

说明

filter

可选的元素。

MobileCapabilities 类提供筛选功能。<deviceFilters> 节中可以有一个或多个筛选器元素。

父元素

元素

说明

configuration

公共语言运行库和 .NET Framework 应用程序所使用的每个配置文件中均需要的根元素。

system.web

指定配置文件中 ASP.NET 配置设置的根元素。包含各种元素,这些元素配置 ASP.NET Web 应用程序并控制这些应用程序的行为方式。

备注

可以从两种设备筛选器中进行选择:比较计算器或鉴别委托。

对于简单的比较,可以通过提供功能的名称和要与之比较的值,指定基于比较的筛选器。在运行时,如果功能值和提供的值相等,则设备筛选器的计算结果为 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、IIS 5.1 或 IIS 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 元素(常规设置架构)

deviceFilters 的 filter 元素(ASP.NET 设置架构)

mobileControls 元素(ASP.NET 设置架构)

MobileCapabilities

System.Configuration

System.Web.Configuration

其他资源

使用设备筛选器

ASP.NET 移动网页

创建 ASP.NET 移动网页

常规配置设置 (ASP.NET)

ASP.NET 配置设置

管理 ASP.NET 网站

ASP.NET 配置文件

ASP.NET 配置 API