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	Common Language Runtime 和 .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 設定結構描述)

屬性和項目

屬性

子項目

父項目

備註

預設組態

範例

項目資訊

請參閱

工作

參考

概念

其他資源

其他資源