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" />
属性と要素
以降のセクションでは、属性、子要素、および親要素について説明します。
属性
属性 |
説明 |
||
|---|---|---|---|
argument |
省略可能な String 型の属性です。 機能の比較対象となる引数を指定します。compare 属性が定義されている場合は、この属性は必須です。 |
||
compare |
省略可能な String 型の属性です。 比較エバリュエータで評価するブラウザ機能を指定します。この機能には、組み込み、またはカスタム機能エバリュエータの名前を指定できます。比較フィルタを指定する場合は、この属性は必須です。 |
||
method |
省略可能な String 型の属性です。 エバリュエータ デリゲートを提供するクラスのメソッドを指定します。エバリュエータ デリゲート型フィルタを指定するときに使用されます。type 属性が指定されている場合は、この属性は必須となり、compare 属性と argument 属性は指定できません。 |
||
name |
必須の String 属性です。 フィルタを識別する一意の名前を指定します。
|
||
type |
省略可能な String 型の属性です。 エバリュエータ デリゲートを提供するクラス型を指定します。 |
.gif "メモ")
メモ :子要素
なし
親要素
要素 |
説明 |
|---|---|
configuration |
共通言語ランタイムおよび .NET Framework アプリケーションで使用されるすべての構成ファイルで必要なルート要素です。 |
system.web |
構成ファイル内に含まれる ASP.NET の構成設定のルート要素を指定します。ASP.NET Web アプリケーションを設定し、アプリケーションの動作方法を制御する構成要素を格納します。 |
deviceFilters |
ユーザー エージェントまたはブラウザに基づいて ASP.NET MobileCapabilities システムのデバイスまたはデバイス クラスを指定します。 |
解説
特定のデバイス向けの Web アプリケーションを作成するときは、1 つ以上のフィルタを構成ファイルの deviceFilters セクションに追加してください。各フィルタによって、ターゲット デバイスに一致するいくつかの条件が指定されます。
デバイス フィルタを構成すると、比較型フィルタとエバリュエータ デリゲート型フィルタの 2 種類のフィルタで評価メカニズムを使用できます。上の構文では、両方の種類のフィルタが指定されています。最初のフィルタは比較型のフィルタで、2 番目のフィルタはエバリュエータ デリゲート型のフィルタを示しています。構成ファイルでフィルタを作成する方法の詳細については、「デバイス固有のレンダリング」を参照してください。
デバイス フィルタでは、大文字と小文字が区別されます。"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 |
参照
処理手順
方法 : Location の設定を使用して特定のディレクトリを構成する
概念
参照
system.web 要素 (ASP.NET 設定スキーマ)
mobileControls 要素 (ASP.NET 設定スキーマ)