次の方法で共有


deviceFilters の filter 要素 (ASP.NET 設定スキーマ)

[このドキュメントはプレビューのみを目的としており、以降のリリースで変更される可能性があります。プレースホルダーとして空白のトピックが含まれています。]

MobileCapabilities クラスのフィルター処理機能を提供します。

<filter name="capability"
        compare="capabilityName"
        argument="argument" />
<filter name="capability"
        type="className"
        method="methodName" />

属性および要素

以降のセクションでは、属性、子要素、および親要素について説明します。

属性

属性

Description

argument

省略可能な String 属性です。

機能の比較対象となる引数を指定します。 compare 属性が定義されている場合は、この属性は必須です。

compare

省略可能な String 属性です。

比較エバリュエーターで評価するブラウザー機能を指定します。 この機能には、組み込み、またはカスタム機能エバリュエーターの名前を指定できます。 比較フィルターを指定する場合は、この属性は必須です。

method

省略可能な String 属性です。

エバリュエーター デリゲートを提供するクラスのメソッドを指定します。 エバリュエーター デリゲート型フィルターを指定するときに使用されます。 type 属性が指定されている場合は、この属性は必須となり、compare 属性と argument 属性は指定できません。

name

必須の String 属性です。

フィルターを識別する一意の名前を指定します。

NoteNote
前に定義されたフィルターと同じ名前のフィルターを、構成ファイルの後半または構成ファイル階層の下位で定義した場合、前に定義されたフィルターはオーバーライドされます。

type

省略可能な String 属性です。

エバリュエーター デリゲートを提供するクラス型を指定します。

子要素

なし。

親要素

要素

Description

configuration

共通言語ランタイムおよび .NET Framework アプリケーションで使用されるすべての構成ファイルで必要なルート要素です。

system.web

構成ファイル内に含まれる ASP.NET の構成設定のルート要素を指定します。 ASP.NET Web アプリケーションを設定し、アプリケーションの動作方法を制御する構成要素を格納します。

deviceFilters

ユーザー エージェントまたはブラウザーに基づいて ASP.NET MobileCapabilities システムのデバイスまたはデバイス クラスを指定します。

解説

特定のデバイス向けの Web アプリケーションを作成するときは、1 つ以上のフィルターを構成ファイルの deviceFilters セクションに追加してください。 各フィルターによって、ターゲット デバイスに一致するいくつかの条件が指定されます。

デバイス フィルターを構成すると、比較型フィルターとエバリュエーター デリゲート型フィルターの 2 種類のフィルターで評価メカニズムを使用できます。 上の構文では、両方の種類のフィルターが指定されています。 最初のフィルターは比較型のフィルターで、2 番目のフィルターはエバリュエーター デリゲート型のフィルターを示しています。 構成ファイルでフィルターを作成する方法の詳細については、「Device-Specific Rendering」を参照してください。

デバイス フィルターでは、大文字と小文字が区別されます。 "isColor" という名前のフィルターと "IsColor" という名前のフィルターは別のものと見なされます。

既定の構成

次の既定の deviceFilters 要素は、マシン構成ファイルやルートの Web.config ファイルでは明示的に構成されていませんが、.NET Framework Version 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>

使用例

比較型フィルターとエバリュエーター デリゲート型フィルターの両方を構成する例を次に示します。 最初のフィルターは比較型のフィルターで、2 番目のフィルターはエバリュエーター デリゲート型のフィルターを示しています。

<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

参照

処理手順

How to: Configure Specific Folders Using Location Settings

How to: Lock ASP.NET Configuration Settings

Reference

system.web 要素 (ASP.NET 設定スキーマ)

configuration 要素 (全般設定スキーマ)

mobileControls 要素 (ASP.NET 設定スキーマ)

MobileCapabilities

System.Configuration

System.Web.Configuration

概念

ASP.NET Configuration File Hierarchy

Securing Configuration

Configuration Inheritance

その他の技術情報

Using Device Filters

ASP.NET Mobile Web Pages

Creating ASP.NET Mobile Web Applications

全般構成設定 (ASP.NET)

ASP.NET 構成設定

Configuring ASP.NET Applications

ASP.NET Configuration Files

ASP.NET Configuration API