MobileCapabilities Class

Definition

Namespace:

System.Web.Mobile

Assembly:

System.Web.Mobile.dll

Caution

The System.Web.Mobile.dll assembly has been deprecated and should no longer be used. For information about how to develop ASP.NET mobile applications, see http://go.microsoft.com/fwlink/?LinkId=157231.

Provides a single source for accessing capability information about a client device and for performing queries against device capabilities. For information about how to develop ASP.NET mobile applications, see Mobile Apps & Sites with ASP.NET.

public ref class MobileCapabilities : System::Web::HttpBrowserCapabilities

[System.Obsolete("The System.Web.Mobile.dll assembly has been deprecated and should no longer be used. For information about how to develop ASP.NET mobile applications, see http://go.microsoft.com/fwlink/?LinkId=157231.")]
public class MobileCapabilities : System.Web.HttpBrowserCapabilities

[<System.Obsolete("The System.Web.Mobile.dll assembly has been deprecated and should no longer be used. For information about how to develop ASP.NET mobile applications, see http://go.microsoft.com/fwlink/?LinkId=157231.")>]
type MobileCapabilities = class
    inherit HttpBrowserCapabilities

Public Class MobileCapabilities
Inherits HttpBrowserCapabilities

Inheritance

Object

HttpCapabilitiesBase

HttpBrowserCapabilities

MobileCapabilities

Attributes

ObsoleteAttribute

Examples

During the page load, the MobileCapabilities object obtains the capabilities through the Browser property as previously discussed. The PreferredRenderingMime and the ScreenCharactersWidth properties of the MobileCapabilities object report back to the browser by setting properties on the HttpResponse object and also by programmatically setting the Text property of certain controls on the page.

<%@ Page Inherits="System.Web.UI.MobileControls.MobilePage"
    Language="c#" %>
<script language="c#" runat="server">
public void Page_Load(Object sender, EventArgs e)
{
    System.Web.Mobile.MobileCapabilities currentCapabilities;
    MobileCapabilities currentCapabilities =
        (MobileCapabilities)Request.Browser;
    // Programmatically find the mobile capabilities without using
    // DeviceSpecific Filters.
    if(currentCapabilities.PreferredRenderingMIME=="text/html")
    {
        Label2.Text = "You are using an html supported device.";
    }
    else if(currentCapabilities.PreferredRenderingMIME ==
        "text/vnd.wap.wml")
    {
        Label2.Text = "You are using a wml supported device.";
    }
    Label1.Text = "Screen Width (chars): " +
        currentCapabilities.ScreenCharactersWidth;
 }
 </script>
 <Mobile:Form runat="server" id=frmTemplate >
      <mobile:label ID="Label1" runat="server" />
      <mobile:label ID="Label2" runat="server" />
 </Mobile:Form>

Remarks

The MobileCapabilities class extends the HttpBrowserCapabilities class. The MobileCapabilities class offers a large number of read-only properties that provide type-safe access to the Browser object's capabilities dictionary.

You can use the Browser property of the HttpRequest object to point to an instance of a MobileCapabilities object, which can then be used to read the capabilities of the requesting browser and device.

Constructors

MobileCapabilities()

Creates an instance of the MobileCapabilities class. This API is obsolete. For information about how to develop ASP.NET mobile applications, see Mobile Apps & Sites with ASP.NET.

Fields

PreferredRenderingTypeChtml10	Returns the source identifier to use for compact HTML 1.0. This field is read-only. This API is obsolete. For information about how to develop ASP.NET mobile applications, see Mobile Apps & Sites with ASP.NET.
PreferredRenderingTypeHtml32	Returns the source identifier to use for HTML 3.2. This field is read-only. This API is obsolete. For information about how to develop ASP.NET mobile applications, see Mobile Apps & Sites with ASP.NET.
PreferredRenderingTypeWml11	Returns the source identifier to use for WML 1.1. This field is read-only. This API is obsolete. For information about how to develop ASP.NET mobile applications, see Mobile Apps & Sites with ASP.NET.
PreferredRenderingTypeWml12	Returns the source identifier to use for WML 1.2. This field is read-only. This API is obsolete. For information about how to develop ASP.NET mobile applications, see Mobile Apps & Sites with ASP.NET.

Properties

ActiveXControls	Gets a value indicating whether the client browser supports ActiveX controls. (Inherited from HttpBrowserCapabilities)
Adapters	Returns the collection of available control adapters. (Inherited from HttpCapabilitiesBase)
AOL	Gets a value indicating whether the client is an America Online (AOL) browser. (Inherited from HttpBrowserCapabilities)
BackgroundSounds	Gets a value indicating whether the client browser supports background sounds. (Inherited from HttpBrowserCapabilities)
Beta	Gets a value indicating whether the browser is a beta release. (Inherited from HttpBrowserCapabilities)
Browser	Gets the browser string (if any) that was transmitted in the User-Agent header. (Inherited from HttpBrowserCapabilities)
Browsers	Gets an ArrayList of the browsers in the Capabilities dictionary. (Inherited from HttpCapabilitiesBase)
CanCombineFormsInDeck	Gets a value indicating whether the browser supports decks that contain multiple forms, such as separate cards. (Inherited from HttpCapabilitiesBase)
CanInitiateVoiceCall	Gets a value indicating whether the browser device is capable of initiating a voice call. (Inherited from HttpCapabilitiesBase)
CanRenderAfterInputOrSelectElement	Gets a value indicating whether the browser supports page content following WML <select> or <input> elements. (Inherited from HttpCapabilitiesBase)
CanRenderEmptySelects	Gets a value indicating whether the browser supports empty HTML <select> elements. (Inherited from HttpCapabilitiesBase)
CanRenderInputAndSelectElementsTogether	Gets a value indicating whether the browser supports WML INPUT and SELECT elements together on the same card. (Inherited from HttpCapabilitiesBase)
CanRenderMixedSelects	Gets a value indicating whether the browser supports WML <option> elements that specify both onpick and value attributes. (Inherited from HttpCapabilitiesBase)
CanRenderOneventAndPrevElementsTogether	Gets a value indicating whether the browser supports WML <onevent> and <prev> elements that coexist within the same WML card. (Inherited from HttpCapabilitiesBase)
CanRenderPostBackCards	Gets a value indicating whether the browser supports WML cards for postback. (Inherited from HttpCapabilitiesBase)
CanRenderSetvarZeroWithMultiSelectionList	Gets a value indicating whether the browser supports WML <setvar> elements with a value attribute of 0. (Inherited from HttpCapabilitiesBase)
CanSendMail	Gets a value indicating whether the browser supports sending email by using the HTML <mailto> element for displaying electronic addresses. (Inherited from HttpCapabilitiesBase)
Capabilities	Used internally to get the defined capabilities of the browser. (Inherited from HttpCapabilitiesBase)
CDF	Gets a value indicating whether the client browser supports Channel Definition Format (CDF) for webcasting. (Inherited from HttpBrowserCapabilities)
ClrVersion	Gets the version number of the .NET common language runtime installed on the client. (Inherited from HttpBrowserCapabilities)
Cookies	Gets a value indicating whether the client browser supports cookies. (Inherited from HttpBrowserCapabilities)
Crawler	Gets a value indicating whether the client browser is a Web crawler search engine. (Inherited from HttpBrowserCapabilities)
DefaultSubmitButtonLimit	Returns the maximum number of Submit buttons that are allowed for a form. (Inherited from HttpCapabilitiesBase)
EcmaScriptVersion	Gets the version number of ECMA script that the client browser supports. (Inherited from HttpBrowserCapabilities)
Frames	Gets a value indicating whether the client browser supports HTML frames. (Inherited from HttpBrowserCapabilities)
GatewayMajorVersion	Gets the major version number of the wireless gateway used to access the server, if known. (Inherited from HttpCapabilitiesBase)
GatewayMinorVersion	Gets the minor version number of the wireless gateway used to access the server, if known. (Inherited from HttpCapabilitiesBase)
GatewayVersion	Gets the version of the wireless gateway used to access the server, if known. (Inherited from HttpCapabilitiesBase)
HasBackButton	Gets a value indicating whether the browser has a dedicated Back button. (Inherited from HttpCapabilitiesBase)
HidesRightAlignedMultiselectScrollbars	Gets a value indicating whether the scrollbar of an HTML <select multiple> element with an align attribute value of right is obscured upon rendering. (Inherited from HttpCapabilitiesBase)
HtmlTextWriter	Gets or sets the fully qualified class name of the HtmlTextWriter to use. (Inherited from HttpCapabilitiesBase)
Id	Gets the internal identifier of the browser as specified in the browser definition file. (Inherited from HttpCapabilitiesBase)
InputType	Returns the type of input supported by browser. (Inherited from HttpCapabilitiesBase)
IsColor	Gets a value indicating whether the browser has a color display. (Inherited from HttpCapabilitiesBase)
IsMobileDevice	Gets a value indicating whether the browser is a recognized mobile device. (Inherited from HttpCapabilitiesBase)
Item[String]	Gets the value of the specified browser capability. In C#, this property is the indexer for the class. (Inherited from HttpCapabilitiesBase)
JavaApplets	Gets a value indicating whether the client browser supports Java applets. (Inherited from HttpBrowserCapabilities)
JavaScript	Gets a value indicating whether the client browser supports JavaScript. (Inherited from HttpBrowserCapabilities)
JScriptVersion	Gets the JScript version that the browser supports. (Inherited from HttpCapabilitiesBase)
MajorVersion	Gets the major (that is, integer) version number of the client browser. (Inherited from HttpBrowserCapabilities)
MaximumHrefLength	Gets the maximum length in characters for the href attribute of an HTML <a> (anchor) element. (Inherited from HttpCapabilitiesBase)
MaximumRenderedPageSize	Gets the maximum length of the page, in bytes, which the browser can display. (Inherited from HttpCapabilitiesBase)
MaximumSoftkeyLabelLength	Returns the maximum length of the text that a soft-key label can display. (Inherited from HttpCapabilitiesBase)
MinorVersion	Gets the minor (that is, decimal) version number of the client browser. (Inherited from HttpBrowserCapabilities)
MinorVersionString	Gets the minor (decimal) version number of the browser as a string. (Inherited from HttpCapabilitiesBase)
MobileDeviceManufacturer	Returns the name of the manufacturer of a mobile device, if known. (Inherited from HttpCapabilitiesBase)
MobileDeviceModel	Gets the model name of a mobile device, if known. (Inherited from HttpCapabilitiesBase)
MSDomVersion	Gets the version of Microsoft HTML (MSHTML) Document Object Model (DOM) that the client browser supports. (Inherited from HttpBrowserCapabilities)
NumberOfSoftkeys	Returns the number of soft keys on a mobile device. (Inherited from HttpCapabilitiesBase)
Platform	Gets the name of the platform that the client uses. (Inherited from HttpBrowserCapabilities)
PreferredImageMime	Returns the MIME type of the type of image content typically preferred by the browser. (Inherited from HttpCapabilitiesBase)
PreferredRenderingMime	Returns the MIME type of the type of content typically preferred by the browser. (Inherited from HttpCapabilitiesBase)
PreferredRenderingType	Gets the general name for the type of content that the browser prefers. (Inherited from HttpCapabilitiesBase)
PreferredRequestEncoding	Gets the request encoding preferred by the browser. (Inherited from HttpCapabilitiesBase)
PreferredResponseEncoding	Gets the response encoding preferred by the browser. (Inherited from HttpCapabilitiesBase)
RendersBreakBeforeWmlSelectAndInput	Gets a value indicating whether the browser renders a line break before <select> or <input> elements. (Inherited from HttpCapabilitiesBase)
RendersBreaksAfterHtmlLists	Gets a value indicating whether the browser renders a line break after list-item elements. (Inherited from HttpCapabilitiesBase)
RendersBreaksAfterWmlAnchor	Gets a value indicating whether the browser renders a line break after a stand-alone HTML <a> (anchor) element. (Inherited from HttpCapabilitiesBase)
RendersBreaksAfterWmlInput	Gets a value indicating whether the browser renders a line break after an HTML <input> element. (Inherited from HttpCapabilitiesBase)
RendersWmlDoAcceptsInline	Gets a value indicating whether the mobile-device browser renders a WML do-based form accept construct as an inline button rather than as a soft key. (Inherited from HttpCapabilitiesBase)
RendersWmlSelectsAsMenuCards	Gets a value indicating whether the browser renders WML <select> elements as menu cards, rather than as a combo box. (Inherited from HttpCapabilitiesBase)
RequiredMetaTagNameValue	Used internally to produce a meta-tag required by some browsers. (Inherited from HttpCapabilitiesBase)
RequiresAttributeColonSubstitution	Gets a value indicating whether the browser requires colons in element attribute values to be substituted with a different character. (Inherited from HttpCapabilitiesBase)
RequiresContentTypeMetaTag	Gets a value indicating whether the browser requires an HTML <meta> element for which the content-type attribute is specified. (Inherited from HttpCapabilitiesBase)
RequiresControlStateInSession	Gets a value indicating whether the browser requires control state to be maintained in sessions. (Inherited from HttpCapabilitiesBase)
RequiresDBCSCharacter	Gets a value indicating whether the browser requires a double-byte character set. (Inherited from HttpCapabilitiesBase)
RequiresHtmlAdaptiveErrorReporting	Gets a value indicating whether the browser requires nonstandard error messages. (Inherited from HttpCapabilitiesBase)
RequiresLeadingPageBreak	Gets a value indicating whether the browser requires the first element in the body of a Web page to be an HTML <br> element. (Inherited from HttpCapabilitiesBase)
RequiresNoBreakInFormatting	Gets a value indicating whether the browser does not support HTML <br> elements to format line breaks. (Inherited from HttpCapabilitiesBase)
RequiresOutputOptimization	Gets a value indicating whether the browser requires pages to contain a size-optimized form of markup language tags. (Inherited from HttpCapabilitiesBase)
RequiresPhoneNumbersAsPlainText	Gets a value indicating whether the browser supports phone dialing based on plain text, or whether it requires special markup. (Inherited from HttpCapabilitiesBase)
RequiresSpecialViewStateEncoding	Gets a value indicating whether the browser requires VIEWSTATE values to be specially encoded. (Inherited from HttpCapabilitiesBase)
RequiresUniqueFilePathSuffix	Gets a value indicating whether the browser requires unique form-action URLs. (Inherited from HttpCapabilitiesBase)
RequiresUniqueHtmlCheckboxNames	Gets a value indicating whether the browser requires unique name attribute values of multiple HTML <input type="checkbox"> elements. (Inherited from HttpCapabilitiesBase)
RequiresUniqueHtmlInputNames	Gets a value indicating whether the browser requires unique name attribute values of multiple HTML <input> elements. (Inherited from HttpCapabilitiesBase)
RequiresUrlEncodedPostfieldValues	Gets a value indicating whether postback data sent by the browser will be UrlEncoded. (Inherited from HttpCapabilitiesBase)
ScreenBitDepth	Returns the depth of the display, in bits per pixel. (Inherited from HttpCapabilitiesBase)
ScreenCharactersHeight	Returns the approximate height of the display, in character lines. (Inherited from HttpCapabilitiesBase)
ScreenCharactersWidth	Returns the approximate width of the display, in characters. (Inherited from HttpCapabilitiesBase)
ScreenPixelsHeight	Returns the approximate height of the display, in pixels. (Inherited from HttpCapabilitiesBase)
ScreenPixelsWidth	Returns the approximate width of the display, in pixels. (Inherited from HttpCapabilitiesBase)
SupportsAccesskeyAttribute	Gets a value indicating whether the browser supports the ACCESSKEY attribute of HTML <a> (anchor) and <input> elements. (Inherited from HttpCapabilitiesBase)
SupportsBodyColor	Gets a value indicating whether the browser supports the bgcolor attribute of the HTML <body> element. (Inherited from HttpCapabilitiesBase)
SupportsBold	Gets a value indicating whether the browser supports HTML <b> elements to format bold text. (Inherited from HttpCapabilitiesBase)
SupportsCacheControlMetaTag	Gets a value indicating whether the browser supports the cache-control value for the http-equiv attribute of HTML <meta> elements. (Inherited from HttpCapabilitiesBase)
SupportsCallback	Gets a value indicating whether the browser supports callback scripts. (Inherited from HttpCapabilitiesBase)
SupportsCss	Gets a value indicating whether the browser supports Cascading Style Sheets (CSS). (Inherited from HttpCapabilitiesBase)
SupportsDivAlign	Gets a value indicating whether the browser supports the align attribute of HTML <div> elements. (Inherited from HttpCapabilitiesBase)
SupportsDivNoWrap	Gets a value indicating whether the browser supports the nowrap attribute of HTML <div> elements. (Inherited from HttpCapabilitiesBase)
SupportsEmptyStringInCookieValue	Gets a value indicating whether the browser supports empty (null) strings in cookie values. (Inherited from HttpCapabilitiesBase)
SupportsFontColor	Gets a value indicating whether the browser supports the color attribute of HTML <font> elements. (Inherited from HttpCapabilitiesBase)
SupportsFontName	Gets a value indicating whether the browser supports the name attribute of HTML <font> elements. (Inherited from HttpCapabilitiesBase)
SupportsFontSize	Gets a value indicating whether the browser supports the size attribute of HTML <font> elements. (Inherited from HttpCapabilitiesBase)
SupportsImageSubmit	Gets a value indicating whether the browser supports using a custom image in place of a standard form Submit button. (Inherited from HttpCapabilitiesBase)
SupportsIModeSymbols	Gets a value indicating whether the browser supports i-mode symbols. (Inherited from HttpCapabilitiesBase)
SupportsInputIStyle	Gets a value indicating whether the browser supports the istyle attribute of HTML <input> elements. (Inherited from HttpCapabilitiesBase)
SupportsInputMode	Gets a value indicating whether the browser supports the mode attribute of HTML <input> elements. (Inherited from HttpCapabilitiesBase)
SupportsItalic	Gets a value indicating whether the browser supports HTML <i> elements to format italic text. (Inherited from HttpCapabilitiesBase)
SupportsJPhoneMultiMediaAttributes	Gets a value indicating whether the browser supports J-Phone multimedia attributes. (Inherited from HttpCapabilitiesBase)
SupportsJPhoneSymbols	Gets a value indicating whether the browser supports J-Phone-specific picture symbols. (Inherited from HttpCapabilitiesBase)
SupportsQueryStringInFormAction	Gets a value indicating whether the browser supports a query string in the action attribute value of HTML <form> elements. (Inherited from HttpCapabilitiesBase)
SupportsRedirectWithCookie	Gets a value indicating whether the browser supports cookies on redirection. (Inherited from HttpCapabilitiesBase)
SupportsSelectMultiple	Gets a value indicating whether the browser supports the multiple attribute of HTML <select> elements. (Inherited from HttpCapabilitiesBase)
SupportsUncheck	Gets a value indicating whether the clearing of a checked HTML <input type=checkbox> element is reflected in postback data. (Inherited from HttpCapabilitiesBase)
SupportsXmlHttp	Gets a value indicating whether the browser supports receiving XML over HTTP. (Inherited from HttpCapabilitiesBase)
Tables	Gets a value indicating whether the client browser supports HTML tables. (Inherited from HttpBrowserCapabilities)
TagWriter	This API supports the product infrastructure and is not intended to be used directly from your code. Used internally to get the type of the object that is used to write tags for the browser. (Inherited from HttpBrowserCapabilities)
Type	Gets the name and major (that is, integer) version number of the client browser. (Inherited from HttpBrowserCapabilities)
UseOptimizedCacheKey	Used internally to get a value indicating whether to use an optimized cache key. (Inherited from HttpCapabilitiesBase)
VBScript	Gets a value indicating whether the client browser supports VBScript. (Inherited from HttpBrowserCapabilities)
Version	Gets the full version number (integer and decimal) of the browser as a string. (Inherited from HttpBrowserCapabilities)
W3CDomVersion	Gets the version of the World Wide Web Consortium (W3C) XML Document Object Model (DOM) that the client browser supports. (Inherited from HttpBrowserCapabilities)
Win16	Gets a value indicating whether the client is a Win16-based computer. (Inherited from HttpBrowserCapabilities)
Win32	Gets a value indicating whether the client is a Win32-based computer. (Inherited from HttpBrowserCapabilities)

Methods

AddBrowser(String)	Used internally to add an entry to the internal collection of browsers for which capabilities are recognized. (Inherited from HttpCapabilitiesBase)
CreateHtmlTextWriter(TextWriter)	Creates a new instance of the HtmlTextWriter to be used. (Inherited from HttpCapabilitiesBase)
DisableOptimizedCacheKey()	Used internally to disable use of an optimized cache key. (Inherited from HttpCapabilitiesBase)
Equals(Object)	Determines whether the specified object is equal to the current object. (Inherited from Object)
GetClrVersions()	Returns all versions of the .NET common language runtime (CLR) installed on the client. (Inherited from HttpBrowserCapabilities)
GetHashCode()	Serves as the default hash function. (Inherited from Object)
GetType()	Gets the Type of the current instance. (Inherited from Object)
HasCapability(String, String)	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 Mobile Apps & Sites with ASP.NET.
Init()	Used internally to initialize an internal set of values. (Inherited from HttpCapabilitiesBase)
IsBrowser(String)	Gets a value indicating whether the client browser is the same as the specified browser. (Inherited from HttpCapabilitiesBase)
MemberwiseClone()	Creates a shallow copy of the current Object. (Inherited from Object)
ToString()	Returns a string that represents the current object. (Inherited from Object)

Explicit Interface Implementations

IFilterResolutionService.CompareFilters(String, String)	Used internally to compare filters. (Inherited from HttpCapabilitiesBase)
IFilterResolutionService.EvaluateFilter(String)	Used internally to evaluate a filter. (Inherited from HttpCapabilitiesBase)

See also

• MobileCapabilities
• Mobile Device Capabilities
• Architectural Overview of Adaptive Control Behavior
• Adapter Sets Functionality