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 属性です。 フィルターを識別する一意の名前を指定します。 .gif "Note") Note
前に定義されたフィルターと同じ名前のフィルターを、構成ファイルの後半または構成ファイル階層の下位で定義した場合、前に定義されたフィルターはオーバーライドされます。
|
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>
要素情報
構成セクション ハンドラー |
|
構成メンバー |
|
構成できる場所 |
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 設定スキーマ)
mobileControls 要素 (ASP.NET 設定スキーマ)
概念
ASP.NET Configuration File Hierarchy
その他の技術情報
Creating ASP.NET Mobile Web Applications