DeviceSpecificChoice.Filter Property

Definition

Namespace:

System.Web.UI.MobileControls

Assembly:

System.Web.Mobile.dll

Gets or sets the name of a device filter. This API is obsolete. For information about how to develop ASP.NET mobile applications, see Mobile Apps & Sites with ASP.NET.

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

public string Filter { get; set; }

member this.Filter : string with get, set

Public Property Filter As String

Property Value

String

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

Remarks

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.

Note

Device filters are case-sensitive.

See also

• Introduction to the DeviceSpecific Control
• <Choice> Element
• <DeviceSpecific> Element