This documentation is archived and is not being maintained.

DeviceSpecificChoice.Filter Property

Gets or sets the name of a device filter. This API is obsolete. For information about how to develop ASP.NET mobile applications, see the www.asp.net/mobile Web site.

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

'Declaration
Public Property Filter As String
	Get
	Set

Property Value

Type: System.String
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.

NoteNote

Device filters are case-sensitive.

.NET Framework

Supported in: 4, 3.5, 3.0, 2.0, 1.1

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.
Show: