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" />
屬性和項目
下列章節會說明屬性 (Attribute)、子項目和父項目。
屬性
屬性 |
描述 |
||
|---|---|---|---|
argument |
選擇性 String 屬性。 指定將用來和功能比較的引數。如果定義了 compare 屬性，則必須有這個屬性。 |
||
compare |
選擇性 String 屬性。 指定由比較評估工具評估的瀏覽器功能。這個功能可以是任何內建功能，或是任何其他自訂功能評估工具的名稱。如果指定比較篩選條件，則必須有這個屬性。 |
||
method |
選擇性 String 屬性。 指定提供評估工具委派的方法。可在指定評估工具委派篩選條件時使用。當指定 type 屬性時，必須有這個屬性，且不能指定 compare 和 argument 屬性。 |
||
name |
必要 String 屬性 指定將用來識別篩選條件的唯一名稱。
|
||
type |
選擇性 String 屬性。 指定提供評估工具委派的類別型別。 |
.gif "注意事項")
注意事項：子項目
無
父項目
項目 |
描述 |
|---|---|
configuration |
Common Language Runtime 和 .NET Framework 應用程式所使用之每一個組態檔中的必要根項目 (Root Element)。 |
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 |
請參閱
工作
概念
參考
system.web 項目 (ASP.NET 設定結構描述)
mobileControls 項目 (ASP.NET 設定結構描述)