deviceFilters与设备过滤

本主题是ASP.NET在移动设备上展示的方面的内容

起初看起来deviceFilters与前面的browserCaps类似。同样也会关联到HttpBrowserCapabilities，而在这里用到的是MobileCapabilities，但是细看后发现browserCaps关注的是浏览器，deviceFilters关注的是设备本身。

定义了设备筛选器之后，您可以将其应用于 ASP.NET 移动控件中以定义特定于设备的呈现。应用的设备筛选器映射到 .aspx 文件中 DeviceSpecific构造内的 <choice> 元素。然后，您可以为这些应用的设备筛选器设置属性重写和模板化。一些特定于设备的自定义示例包括：

重写控件的属性，例如根据显示功能为 Image 控件选择不同的图像。
对不同的移动设备使用不同的呈现样式。
在设备（例如 Pocket PC）上使用模板实现更丰富的呈现。

这些方案中的每一个都需要根据目标设备是否与 Web.config 文件中的 <deviceFilters> 节匹配来进行筛选。这些筛选器也可能遍布在应用程序中，而不是只出现在一个地方。

实际上服务端从一个HTTP请求得知这些信息，请求头肯定有附带。在面前的内容知道，浏览器的信息通过对User-Agent的识别，再通过浏览器功能定义，把结果存放在HttpBrowserCapabilities中，而这里对设备功能判定的就是基于这里得出的HttpBrowserCapabilities来进行。

ASP.NET内置的设备功能可查看附表1

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

对于简单的比较，可以通过提供功能的名称和要与之比较的值，指定基于比较的筛选器。在运行时，如果功能值和提供的值相等，则设备筛选器的计算结果为 true。布尔值属性在比较时不区分大小写；因此，true 和 True 都有效。其他属性比较区分大小写。

对于更复杂的计算，您可以通过提供方法的类和方法名指定基于计算委托的筛选器。在运行时，调用所提供的方法来确定设备筛选器的计算结果是否为 true。

在Web.config文件中配置如下
```
<deviceFilters>
<filter name="IsHtml" 
compare="PreferredRendering" 
argument="html32" />
<filter name="GPSEnabled" 
type="MyApplication.MyCapabilityEvaluators,MyApplication" 
method="IsGPSEnabled" />
</deviceFilters>
```
对于第一个filter是用比较计算器的，compare特性是指定由比较计算器计算的浏览器功能。该功能可以是任何内置功能，也可以是任何其他自定义功能计算器的名称。argument特性是指定该功能应与之比较的参数；

对于第二个filter是用计算委托，type是指定提供计算委托的类类型。是类的完全限定名：（类的全名+","+程序集名称）,method特性是指定提供计算委托的方法。

下面的示例演示如何定义名为 isHTML32 的设备筛选器。
```
<filter name="isHTML32" compare="PreferredRenderingType" argument="html32" />
```
在运行时，此筛选器将当前请求的 MobileCapabilities 实例的 PreferredRenderingType 属性值与值 html32 进行比较。

下面的示例演示如何定义名为 GPSEnabled 的新功能。
```
namespace MyAssembly
{
publicclass MyCapabilityEvaluators
{
publicstaticbool IsGPSEnabled(
System.Web.Mobile.MobileCapabilities capabilities,
String unusedArg)
{
// processing code
}
}
}
```
将以下元素添加到适当的 Web.config 文件以添加新功能：
```
<filter name="GPSEnabled" 
type="MyNamespace.MyCapabilityEvaluators, MyAssembly"
method="IsGPSEnabled" />
```
如果使用 Filter 属性指定方法名称，则该方法必须符合以下原型
```
public bool methodName(
System.Web.Mobile.MobileCapabilities capabilities,
String optionalArgument);
```
若需要获取设备是否支持指定功能可以使用以下方式

对于内置的功能除了可以用MobileCapabilities的属性进行比较外，还可以这样子
```
((System.Web.Mobile.MobileCapabilities)System.Web.HttpContext.Current.Request.Browser).HasCapability("ScreenBitDepth", "8");
```
返回的是一个bool值，表明是否具备该功能；

对于自定义的功能，只能通过HasCapability
```
((System.Web.Mobile.MobileCapabilities)System.Web.HttpContext.Current.Request.Browser).HasCapability("GPSEnabled", null);
```
HasCapability 方法使用两个参数：capabilityName，它是功能字典中设备计算方法、属性或项的名称；optionalArgument，它是 capabilityName参数需要的任何参数。 HasCapability 方法按照以下顺序执行其计算：

它检查 capabilityName 值是否是 Web.config 文件中指定的设备筛选器的名称。

注意

HasCapability 方法通过将 optionalArgument 参数设置为 null 来计算 <DeviceSpecific> 和 <Choice> 构造。

如果第 1 步中的测试返回 true 并且筛选器是委托计算器（使用自定义方法计算指定数据的筛选器），则 HasCapability 方法将使用optionalArgument 参数中提供的参数调用委托并返回结果。
如果第 1 步中的测试返回 true 并且筛选器是比较计算器（将功能名与某个指定的值进行比较的筛选器），则 HasCapability 方法将使用该功能名和计算器中提供的参数（忽略所有原始 optionalArgument 参数）调用其本身并返回结果。
如果 MobileCapabilities 对象具有名为 capabilityName 的属性，则 HasCapability 方法将此属性强制转换为字符串并在optionalArgument 值等于该字符串时返回 true。布尔型比较不区分大小写；其他比较区分大小写。因此，"true"等同于"True"，但"left"不等于"Left"。
如果不存在任何 capabilityName 属性，则 HasCapability 方法将在与 MobileCapabilities 对象关联的功能字典中进行查找。如果capabilityName 属性存在，则 HasCapability 方法将其与 optionalArgument 参数进行比较并返回结果。因为字典可以维护字符串，所以无需进行强制转换。
如果这些测试失败，HasCapability 方法将引发 ArgumentOutOfRangeException 异常。

附表1

下表从适配器开发人员的角度列出了 ASP.NET 移动控件设备属性及有效的标记语言。此表还列出对于应用程序逻辑中的常规使用有效、从而适用于所有标记语言的属性（通常不是呈现标记的属性）。

Property	常规使用	HTML 和 XHTML	cHTML	WML
Browser	是	是	是	是
CanCombineFormsInDeck	否	否	否	是
CanInitiateVoiceCall	是	是	是	是
CanRenderEmptySelects	是	是	是	是
CanRenderInputAndSelectElementsTogether	否	否	否	是
CanRenderMixedSelects	否	否	否	是
CanRenderOneventAndPrevElementsTogether	否	否	否	是
CanRenderPostBackCards	否	否	否	是
CanRenderSetvarZeroWithMultiSelectionList	否	否	否	是
CanSendMail	是	是	是	是
DefaultSubmitButtonLimit	是	是	是	是
GatewayMajorVersion	是	是	是	是
GatewayMinorVersion	是	是	是	是
GatewayVersion	是	是	是	是
HasBackButton	否	否	否	是
HidesRightAlignedMultiselectScrollbars	否	是	是	否
InputType	是	是	是	是
IsColor	是	是	是	是
IsMobileDevice	是	是	是	是
Item	是	是	是	是
MaximumRenderedPageSize	否	否	是	是
MaximumSoftkeyLabelLength	否	否	否	是
MobileDeviceManufacturer	是	是	是	是
MobileDeviceModel	是	是	是	是
NumberOfSoftkeys	是	是	是	是
PreferredImageMime	是	是	是	是
PreferredRenderingMime	是	是	是	是
PreferredRenderingType	是	是	是	是
RendersBreakBeforeWmlSelectAndInput	否	否	否	是
RendersBreaksAfterHtmlLists	否	是	是	否
RendersBreaksAfterWmlAnchor	否	否	否	是
RendersBreaksAfterWmlInput	否	否	否	是
RendersWmlDoAcceptsInline	否	否	否	是
RendersWmlSelectsAsMenuCards	否	否	否	是
RequiredMetaTagNameValue	否	是	是	否
RequiresContentTypeMetaTag	否	是	是	否
RequiresAttributeColonSubstitution	否	是	是	否
RequiresHtmlAdaptiveErrorReporting	否	是	是	是
RequiresLeadingPageBreak	否	是	是	是
RequiresNoBreakInFormatting	否	是	是	是
RequiresOutputOptimization	否	否	是	否
RequiresPhoneNumbersAsPlainText	否	否	否	是
RequiresSpecialViewStateEncoding	否	否	否	是
RequiresUniqueFilePathSuffix	否	是	是	是
RequiresUniqueHtmlCheckboxNames	否	否	是	否
RequiresUniqueHtmlInputNames	是	是	是	是
RequiresUrlEncodedPostfieldValues	否	否	否	是
ScreenBitDepth	是	是	是	是
ScreenCharactersHeight	是	是	是	是
ScreenCharactersWidth	是	是	是	是
ScreenPixelsHeight	是	是	是	是
ScreenPixelsWidth	是	是	是	是
SupportsAccesskeyAttribute	否	是	是	否
SupportsBodyColor	否	是	是	否
SupportsBold	否	是	是	否
SupportsCacheControlMetaTag	否	否	否	是
SupportsCss	是	是	是	是
SupportsDivAlign	否	是	是	否
SupportsDivNoWrap	否	是	是	否
SupportsFontColor	否	是	是	否
SupportsFontName	否	是	是	否
SupportsFontSize	否	是	是	否
SupportsImageSubmit	否	是	是	否
SupportsIModeSymbols	否	否	是	否
SupportsInputIStyle	否	否	是	否
SupportsInputMode	否	否	是	否
SupportsItalic	否	是	是	否
SupportsJPhoneMultiMediaAttributes	否	是	是	否
SupportsJPhoneSymbols	否	否	是	否
SupportsQueryStringInFormAction	否	是	是	是
SupportsSelectMultiple	否	否	是	否
SupportsUncheck	是	是	是	是

MSDN参考

移动设备功能（总览页）

来自 <https://msdn.microsoft.com/zh-cn/library/wa9x6tza(v=vs.100).aspx>

设备筛选建议

来自 <https://msdn.microsoft.com/zh-cn/library/8xef2eak(v=vs.100).aspx>

设备功能表

来自 <https://msdn.microsoft.com/zh-cn/library/dcwa1kf5(v=vs.100).aspx>

为多个设备配置 Web 应用程序

来自 <https://msdn.microsoft.com/zh-cn/library/fcs06t52(v=vs.100).aspx>

以编程方式计算功能

来自 <https://msdn.microsoft.com/zh-cn/library/2cf6d1wd(v=vs.100).aspx>

设备计算方法

来自 <https://msdn.microsoft.com/zh-cn/library/hweskhy5(v=vs.100).aspx>

posted @ 2016-09-18 06:55 猴健居士阅读(1726) 评论(0) 收藏举报

刷新页面返回顶部

deviceFilters与设备过滤

公告