deviceFilters 要素 (ASP.NET 設定スキーマ)
ユーザー エージェントまたはブラウザーに基づいて ASP.NET MobileCapabilities システムのデバイスまたはデバイス クラスを指定します。 デバイス フィルターは、ページまたはアプリケーションの開発者がコントロールのプロパティをオーバーライドする場合や、コンテンツまたはテンプレートのブロックを定義してレイアウトと外観を変更する場合に使用できます。
<deviceFilters>
<filter.../>
</deviceFilters>
属性および要素
以降のセクションでは、属性、子要素、および親要素について説明します。
属性
なし。
子要素
要素 |
説明 |
|---|---|
filter |
省略可能な要素です。 MobileCapabilities クラスのフィルター処理機能を提供します。 <deviceFilters> セクションには、1 つ以上のフィルター要素を含めることができます。 |
親要素
要素 |
説明 |
|---|---|
configuration |
共通言語ランタイムおよび .NET Framework アプリケーションで使用されるすべての構成ファイルで必要なルート要素です。 |
system.web |
構成ファイル内に含まれる ASP.NET の構成設定のルート要素を指定します。 ASP.NET Web アプリケーションを設定し、アプリケーションの動作方法を制御する要素を格納します。 |
解説
デバイス フィルターは、比較エバリュエーターとエバリュエーター デリゲートの 2 種類から選択できます。
単純比較の場合は、機能の名前と比較対象の値を提供することによって、比較型フィルターを指定できます。 実行時に、このデバイス フィルターは、機能の値と指定された値が等しい場合に true と評価します。 ブール型のプロパティは大文字と小文字を区別しないで比較されるため、true と True は共に有効です。 その他のプロパティの比較では、大文字と小文字が区別されます。
複雑な評価を行う場合は、メソッドのクラスとメソッド名を指定することによって、エバリュエーター デリゲート型フィルターを指定できます。 実行時には、指定されたメソッドが呼び出され、このデバイス フィルターで true と評価されるかどうかを判断します。
既定の構成
次の既定の <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>
使用例
比較型フィルターとエバリュエーター デリゲート型フィルターの両方を構成する例を次に示します。
<deviceFilters>
<filter name="IsHtml"
compare="PreferredRendering"
argument="html32" />
<filter name="IsGPSEnabled"
type="MyApplication.MyCapabilityEvaluators,MyApplication"
method="IsGPSEnabled" />
</deviceFilters>
要素情報
Configuration Section Handler |
|
Configuration Member |
|
Configurable Locations |
Machine.config ルート レベルの Web.config アプリケーション レベルの Web.config Web.config |
Requirements |
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 設定スキーマ)
deviceFilters の filter 要素 (ASP.NET 設定スキーマ)
mobileControls 要素 (ASP.NET 設定スキーマ)