DeviceSpecificChoice.Filter プロパティ

.NET Framework クラス ライブラリ リファレンス

DeviceSpecificChoice.Filter プロパティ

デバイス フィルタの名前を取得または設定します。

名前空間: System.Web.UI.MobileControls
アセンブリ: System.Web.Mobile (system.web.mobile.dll 内)
構文

Visual Basic (宣言)

Public Property Filter As
 String

Visual Basic (使用法)

Dim instance As DeviceSpecificChoice
Dim value As String

value = instance.Filter

instance.Filter = value

C#

public string Filter { get;
 set; }

C++

public:
property String^ Filter {
    String^ get ();
    void set (String^ value);
}

J#

/** @property */
public String get_Filter ()

/** @property */
public void set_Filter (String value)

JScript

public function get Filter
 () : String

public function set Filter
 (value : String)

プロパティ値
デバイス フィルタの名前。既定値は空の文字列 ("") です。

解説

フィルタ名は、関連付けられている .ascx ファイル内でページ上のメソッドの名前になっているか、Web.config の <deviceFilters> セクションで定義されている有効なデバイス フィルタの名前に一致する必要があります。Filter プロパティでメソッド名を指定する場合は、そのメソッドが次のプロトタイプに一致している必要があります。

public bool methodName(System.Web.Mobile.MobileCapabilities 
    capabilities, String optionalArgument)

たとえば、Filter プロパティの値を myChoiceMethod に設定する場合、次のシグネチャを持つメソッドが存在している必要があります。

public bool myChoiceMethod(System.Web.Mobile.MobileCapabilities 
    capabilities, String optionalArgument);

<Choice> 要素を評価するときには、メソッドの適切なシグネチャがページにあるかどうかを判断するチェックが行われます。存在しない場合は、ASP.NET が web.config の <deviceFilters> セクションをチェックします。

メモ
デバイス フィルタでは、大文字と小文字が区別されます。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1

参照

関連項目
DeviceSpecificChoice クラス
DeviceSpecificChoice メンバ
System.Web.UI.MobileControls 名前空間
その他の技術情報
DeviceSpecific コントロールの概要
<Choice> 要素 (.NET Framework 開発者ガイド)
<DeviceSpecific> 要素