Export (0) Print
Expand All

DeviceSpecificChoice.Filter Property

Gets or sets the name of a device filter.

Namespace: System.Web.UI.MobileControls
Assembly: System.Web.Mobile (in system.web.mobile.dll)

public string Filter { get; set; }
/** @property */
public String get_Filter ()

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

public function get Filter () : String

public function set Filter (value : String)

Not applicable.

Property Value

The name of a device filter. The default value is an empty string ("").

The filter name must be the name of a method on the page, in the associated .ascx file, or the name of a valid device filter defined in the <deviceFilters> section of Web.config. If a method name is specified with the Filter property, that method must match the following prototype.

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

For example, if the Filter property was set to myChoiceMethod, a method with the following signature must exist.

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

When evaluating the <Choice> element, a check is made to determine whether a method of the appropriate signature exists on the page. If not, ASP.NET checks the <deviceFilters> section of Web.config.


Device filters are case-sensitive.

Windows 98, Windows Server 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

The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.

.NET Framework

Supported in: 3.0, 2.0, 1.1

Community Additions

© 2014 Microsoft