This documentation is archived and is not being maintained.

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:
property String^ Filter {
	String^ get ();
	void set (String^ value);
}

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.

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

The .NET Framework and .NET Compact Framework do not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

.NET Framework

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