MobileCapabilities Class

Definition

Warning

This API is now obsolete.

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
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.")]
public class MobileCapabilities : System.Web.HttpBrowserCapabilities
type MobileCapabilities = class
    inherit HttpBrowserCapabilities
Public Class MobileCapabilities
Inherits HttpBrowserCapabilities
Inheritance
Attributes

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
CanCombineFormsInDeck

Gets a value indicating whether the browser supports decks that contain multiple forms, such as separate cards.

(Inherited from HttpCapabilitiesBase)
CanInitiateVoiceCall
CanInitiateVoiceCall

Gets a value indicating whether the browser device is capable of initiating a voice call.

(Inherited from HttpCapabilitiesBase)
CanRenderAfterInputOrSelectElement
CanRenderAfterInputOrSelectElement

Gets a value indicating whether the browser supports page content following WML <select> or <input> elements.

(Inherited from HttpCapabilitiesBase)
CanRenderEmptySelects
CanRenderEmptySelects

Gets a value indicating whether the browser supports empty HTML <select> elements.

(Inherited from HttpCapabilitiesBase)
CanRenderInputAndSelectElementsTogether
CanRenderInputAndSelectElementsTogether

Gets a value indicating whether the browser supports WML INPUT and SELECT elements together on the same card.

(Inherited from HttpCapabilitiesBase)
CanRenderMixedSelects
CanRenderMixedSelects

Gets a value indicating whether the browser supports WML <option> elements that specify both onpick and value attributes.

(Inherited from HttpCapabilitiesBase)
CanRenderOneventAndPrevElementsTogether
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
CanRenderPostBackCards

Gets a value indicating whether the browser supports WML cards for postback.

(Inherited from HttpCapabilitiesBase)
CanRenderSetvarZeroWithMultiSelectionList
CanRenderSetvarZeroWithMultiSelectionList

Gets a value indicating whether the browser supports WML <setvar> elements with a value attribute of 0.

(Inherited from HttpCapabilitiesBase)
CanSendMail
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
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
GatewayMajorVersion

Gets the major version number of the wireless gateway used to access the server, if known.

(Inherited from HttpCapabilitiesBase)
GatewayMinorVersion
GatewayMinorVersion

Gets the minor version number of the wireless gateway used to access the server, if known.

(Inherited from HttpCapabilitiesBase)
GatewayVersion
GatewayVersion

Gets the version of the wireless gateway used to access the server, if known.

(Inherited from HttpCapabilitiesBase)
HasBackButton
HasBackButton

Gets a value indicating whether the browser has a dedicated Back button.

(Inherited from HttpCapabilitiesBase)
HidesRightAlignedMultiselectScrollbars
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
InputType

Returns the type of input supported by browser.

(Inherited from HttpCapabilitiesBase)
IsColor
IsColor

Gets a value indicating whether the browser has a color display.

(Inherited from HttpCapabilitiesBase)
IsMobileDevice
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
MaximumRenderedPageSize

Gets the maximum length of the page, in bytes, which the browser can display.

(Inherited from HttpCapabilitiesBase)
MaximumSoftkeyLabelLength
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
MobileDeviceManufacturer

Returns the name of the manufacturer of a mobile device, if known.

(Inherited from HttpCapabilitiesBase)
MobileDeviceModel
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
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
PreferredImageMime

Returns the MIME type of the type of image content typically preferred by the browser.

(Inherited from HttpCapabilitiesBase)
PreferredRenderingMime
PreferredRenderingMime

Returns the MIME type of the type of content typically preferred by the browser.

(Inherited from HttpCapabilitiesBase)
PreferredRenderingType
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
RendersBreakBeforeWmlSelectAndInput

Gets a value indicating whether the browser renders a line break before <select> or <input> elements.

(Inherited from HttpCapabilitiesBase)
RendersBreaksAfterHtmlLists
RendersBreaksAfterHtmlLists

Gets a value indicating whether the browser renders a line break after list-item elements.

(Inherited from HttpCapabilitiesBase)
RendersBreaksAfterWmlAnchor
RendersBreaksAfterWmlAnchor

Gets a value indicating whether the browser renders a line break after a stand-alone HTML <a> (anchor) element.

(Inherited from HttpCapabilitiesBase)
RendersBreaksAfterWmlInput
RendersBreaksAfterWmlInput

Gets a value indicating whether the browser renders a line break after an HTML <input> element.

(Inherited from HttpCapabilitiesBase)
RendersWmlDoAcceptsInline
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
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
RequiredMetaTagNameValue

Used internally to produce a meta-tag required by some browsers.

(Inherited from HttpCapabilitiesBase)
RequiresAttributeColonSubstitution
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
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
RequiresDBCSCharacter

Gets a value indicating whether the browser requires a double-byte character set.

(Inherited from HttpCapabilitiesBase)
RequiresHtmlAdaptiveErrorReporting
RequiresHtmlAdaptiveErrorReporting

Gets a value indicating whether the browser requires nonstandard error messages.

(Inherited from HttpCapabilitiesBase)
RequiresLeadingPageBreak
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
RequiresNoBreakInFormatting

Gets a value indicating whether the browser does not support HTML <br> elements to format line breaks.

(Inherited from HttpCapabilitiesBase)
RequiresOutputOptimization
RequiresOutputOptimization

Gets a value indicating whether the browser requires pages to contain a size-optimized form of markup language tags.

(Inherited from HttpCapabilitiesBase)
RequiresPhoneNumbersAsPlainText
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
RequiresSpecialViewStateEncoding

Gets a value indicating whether the browser requires VIEWSTATE values to be specially encoded.

(Inherited from HttpCapabilitiesBase)
RequiresUniqueFilePathSuffix
RequiresUniqueFilePathSuffix

Gets a value indicating whether the browser requires unique form-action URLs.

(Inherited from HttpCapabilitiesBase)
RequiresUniqueHtmlCheckboxNames
RequiresUniqueHtmlCheckboxNames

Gets a value indicating whether the browser requires unique name attribute values of multiple HTML <input type="checkbox"> elements.

(Inherited from HttpCapabilitiesBase)
RequiresUniqueHtmlInputNames
RequiresUniqueHtmlInputNames

Gets a value indicating whether the browser requires unique name attribute values of multiple HTML <input> elements.

(Inherited from HttpCapabilitiesBase)
RequiresUrlEncodedPostfieldValues
RequiresUrlEncodedPostfieldValues

Gets a value indicating whether postback data sent by the browser will be UrlEncoded.

(Inherited from HttpCapabilitiesBase)
ScreenBitDepth
ScreenBitDepth

Returns the depth of the display, in bits per pixel.

(Inherited from HttpCapabilitiesBase)
ScreenCharactersHeight
ScreenCharactersHeight

Returns the approximate height of the display, in character lines.

(Inherited from HttpCapabilitiesBase)
ScreenCharactersWidth
ScreenCharactersWidth

Returns the approximate width of the display, in characters.

(Inherited from HttpCapabilitiesBase)
ScreenPixelsHeight
ScreenPixelsHeight

Returns the approximate height of the display, in pixels.

(Inherited from HttpCapabilitiesBase)
ScreenPixelsWidth
ScreenPixelsWidth

Returns the approximate width of the display, in pixels.

(Inherited from HttpCapabilitiesBase)
SupportsAccesskeyAttribute
SupportsAccesskeyAttribute

Gets a value indicating whether the browser supports the ACCESSKEY attribute of HTML <a> (anchor) and <input> elements.

(Inherited from HttpCapabilitiesBase)
SupportsBodyColor
SupportsBodyColor

Gets a value indicating whether the browser supports the bgcolor attribute of the HTML <body> element.

(Inherited from HttpCapabilitiesBase)
SupportsBold
SupportsBold

Gets a value indicating whether the browser supports HTML <b> elements to format bold text.

(Inherited from HttpCapabilitiesBase)
SupportsCacheControlMetaTag
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
SupportsCss

Gets a value indicating whether the browser supports Cascading Style Sheets (CSS).

(Inherited from HttpCapabilitiesBase)
SupportsDivAlign
SupportsDivAlign

Gets a value indicating whether the browser supports the align attribute of HTML <div> elements.

(Inherited from HttpCapabilitiesBase)
SupportsDivNoWrap
SupportsDivNoWrap

Gets a value indicating whether the browser supports the nowrap attribute of HTML <div> elements.

(Inherited from HttpCapabilitiesBase)
SupportsEmptyStringInCookieValue
SupportsEmptyStringInCookieValue

Gets a value indicating whether the browser supports empty (null) strings in cookie values.

(Inherited from HttpCapabilitiesBase)
SupportsFontColor
SupportsFontColor

Gets a value indicating whether the browser supports the color attribute of HTML <font> elements.

(Inherited from HttpCapabilitiesBase)
SupportsFontName
SupportsFontName

Gets a value indicating whether the browser supports the name attribute of HTML <font> elements.

(Inherited from HttpCapabilitiesBase)
SupportsFontSize
SupportsFontSize

Gets a value indicating whether the browser supports the size attribute of HTML <font> elements.

(Inherited from HttpCapabilitiesBase)
SupportsImageSubmit
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
SupportsIModeSymbols

Gets a value indicating whether the browser supports i-mode symbols.

(Inherited from HttpCapabilitiesBase)
SupportsInputIStyle
SupportsInputIStyle

Gets a value indicating whether the browser supports the istyle attribute of HTML <input> elements.

(Inherited from HttpCapabilitiesBase)
SupportsInputMode
SupportsInputMode

Gets a value indicating whether the browser supports the mode attribute of HTML <input> elements.

(Inherited from HttpCapabilitiesBase)
SupportsItalic
SupportsItalic

Gets a value indicating whether the browser supports HTML <i> elements to format italic text.

(Inherited from HttpCapabilitiesBase)
SupportsJPhoneMultiMediaAttributes
SupportsJPhoneMultiMediaAttributes

Gets a value indicating whether the browser supports J-Phone multimedia attributes.

(Inherited from HttpCapabilitiesBase)
SupportsJPhoneSymbols
SupportsJPhoneSymbols

Gets a value indicating whether the browser supports J-Phone-specific picture symbols.

(Inherited from HttpCapabilitiesBase)
SupportsQueryStringInFormAction
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
SupportsRedirectWithCookie

Gets a value indicating whether the browser supports cookies on redirection.

(Inherited from HttpCapabilitiesBase)
SupportsSelectMultiple
SupportsSelectMultiple

Gets a value indicating whether the browser supports the multiple attribute of HTML <select> elements.

(Inherited from HttpCapabilitiesBase)
SupportsUncheck
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

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)

Applies to

See also