This documentation is archived and is not being maintained.

MobileCapabilities.HasCapability Method

Provides a uniform way to evaluate device capabilities. This method is used internally by ASP.NET to implement various device-selection criteria expressed in the syntax of the controls. For example, this method is used to choose among <Choice> Element (.NET Framework Developer's Guide ) elements in a DeviceSpecific/Choice construct. This API is obsolete. For information about how to develop ASP.NET mobile applications, see the Web site.

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

public bool HasCapability(
	string delegateName,
	string optionalParameter


Type: System.String
The device evaluation method, property name, or item in the capabilities collection.
Type: System.String
The optional argument.

Return Value

Type: System.Boolean
true if the device has the specified capability; otherwise, false.


A capabilityName parameter is not found as a device-filter name specified in the configuration file, as a MobileCapabilities property, or as an item in the MobileCapabilities Item collection.


delegateName is null or empty.

Applications can use the HasCapability method programmatically when they gather device-specific information. If the capabilityName parameter specifies a device evaluation method, the optionalArgument parameter is passed to this method. If the capabilityName parameter specifies a property name or item in the capabilities dictionary, the HasCapability method checks whether the property or item is equal to the optionalArgument parameter.

.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.